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Teach Yoursek VISUALLY’ z 


Are you a visual learner? Do you prefer instructions You'll learn to: 


that show you how to do something—and skip the 
long-winded explanations? If so, then this book is 
for you. Open it up and you’ll find clear, step-by- 
step screen shots that show you how to tackle over 
a hundred Python tasks. Each task-based spread 
covers a single technique, sure to help you get up 
and running with Python in no time. 


™ 


¢ Install Python and get coding 

¢ Work interactively and create scripts 
¢ Manipulate directories and files 

¢ Make decisions and repeat actions 


¢ Develop powerful functions 


CHAPTER 


Navigate Among Directories 


Working with Files and Directories 


@ lype the following statement, which uses the getcwd () 
method of the os module, and then press G@IEB: 


os.getewd() 


ython’s os module provides the tools you need to navigate among the directories in the 

computer's file system. You can use the expanduser () method of the path object in the os 
module to return the path to the user’s home directory and then use the chdir() method of the 
os module to switch to that directory. You can use the isfile() method of the os module to 
determine whether a particular directory is present; if it is, you can navigate to the directory and 
then navigate back up from it. 


Python displays the current working directory, such as 
'C:\\Users\\Ted' on Windows or '/Users/guy' 
on mac0S. See the tip for an explanation of the use of \\. 


© ype the following two-line if statement, which uses the 


| Navigate Among Directories | ‘Amo ng Directories | 


© Open a terminal window and launch Python. 


@ The Python prompt appears. 


@ Jype the following statement, which imports the 
os module, and then press (I073- 


import os 


isdir () method of the path object in the os module 
to determine whether the Pictures directory exists 
in the current directory and changes directory to it if it 
does. Press (iE at the end of each line, and then press 
(GED again to end the statement. 
if os.path.isdir("P: 3 

os. chdir ("Pictu 


Note: Indent the second line of the if statement by four 
spaces. 


f5935c, Oct 4 2021, 
15.0.22-13)] on 
erediva" or" 


© Type the following statement, which creates a 
variable named thisdir and assigns to it the 
result of using the getcwa() method of the os @ ‘ype the following statement, which uses the 
module. Press (=It- dirname () method of the path object in the os 

module to return the parent directory of the current 

working directory, and the chdix() method of the os 

@ ‘ype the following statement, which uses the module to switch to it. Press GIT. 
print () function to display the contents of os. chdir(os.path.dirname(os.getewd())) 


thisdir. Press GIN. 


print (thisdir) 


thisdir = os.getcwd() 


©® Type the following statement to change to the original 
directory, and then press (NC: 
Python displays the current directory. TR 3 = os.chdir(thisdir) 


oO 
yy/Muste/Muste/Muste! 


© ype the following statement, which creates a 
variable named homedir and assigns to it the 
result of using the expanduser () method of 
the path object in the os module. Press ENS. 


@® Press G9 five times to repeat the os. getcwd () 
statement, and then press 


os.getewd() 


sidaaduie Valueceath “aepanaasen (nin) Python displays the directory from which you started. 
Note: The expanduser () method here takes the 
argument ~, which represents the current user’s home 
directory. Why does Python show \\ instead of \ in Windows paths? 

Python uses the backslash, \, as an escape character, a character that modifies the following character 
rather than being executed as itself. Here, \\ represents a single “real” backslash in the path. So the path 
that Python shows as c: \\Users\\Ted is really c: \Users\Ted. You might think of \\ as an escaped 
escape character. 


© lype the following statement, which uses the 
chdir() method of the os module to change 
directory to homedir. Press GYS3. 


os.chdir (homedir) 
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How to Use This Book 


Who This Book Is For 


This book is for the reader who has never used this 
particular technology or software application. It is 


3] Icons and Buttons 


Icons and buttons show you exactly what you need to 
click to perform a step. 


also for readers who want to expand their knowledge. 4) Tips 


The Conventions in This Book 


@ Steps 


This book uses a step-by-step format to guide you 


easily through each task. Numbered steps are 


actions you must do; bulleted steps clarify a point, 
step, or optional feature; and indented steps give 


you the result. 


@ Notes 
Notes give additional information — special 


conditions that may occur during an operation, a 


Tips offer additional information, including warnings 
and shortcuts. 


@ Bold 


Bold type shows command names, options, and text 
or numbers you must type. 


6) Italics 


Italic type introduces and defines a new term. 


situation that you want to avoid, or a cross-reference 


to a related area of the book. 


Add Comments to Your Code 


dding comments to your code can help you develop functional code more quickly and can help 
others understand, maintain, and extend your code. While writing code, add comments freely 
describing the code’s tasks and your current approach. Revise the comments as you progress and 
change your code. Once the code is working, clean up the comments, removing any development- 
related comments and adding any further explanation that is needed_or might be helpful. 
You can also use the comment character, #, to comment a « \ to prevent them from 
running without removing them from the script. 


Add Comments to Your Code 


Open Visual Studio Code, create a new script, 
and save it under a name of your choice. 


@ ‘ype the following statement, which creates a 
comment, and then press (it: 
4 prompt the user for their name 

@ Visual Studio Code displays the comment text in 

green to make it easy to see in your scripts. 

© Type the following statement, which creates a 
variable named u and assigns to it the result of 
the input () function, prompting the user for 
their name. Press 


u = input ("Type your name: ") 


@ ‘pe the following comment, and then 
press : 


# display the name entered 


© ype the following statement, which uses the 
print () function to display a message that 
includes the contents of u. Press 


print ("You are " + u + ".") 
@ Click Run Python File in Terminal (D> 
The Terminal pane opens. 
@ Slick in the Terminal pane. 
© We a name, and then press GED. 
Python displays the message. 
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CHAPTER 


Writing and Running Your First Python Code 


Comment Out a Statement and oon rg ooo w 

Uncomment It Again oe 

@ Click at the beginning of line 2, and then type 
# and a space so the line reads like this: 


# u = input ("Type your name: ") 


@ Visual Studio Code displays the line in green, 
because it is now a comment. 


@© Slick at the end of line 2, and then 
press 


Visual Studio Code creates a new line. 


© ‘ype the following statement, which creates a 
variable named u: and assigns the value Ivy to it. 


us "Ivy" 


@ Still on the same line, type a comment so the 
line reads like this: 


u = "Ivy" # default name for testy 
© Click Run Python File in mms ol 
© The message appears, showing the default name. 
@ Slick in tine 2 and press @D+@. 
@ Visual Studio Code uncomments line 2. 
@>«: On the Mac, press £9+@2. 
@ Sick in line 3 and press GImED+@B. 


Visual Studio Code comments out line 3. 


Why does Visual Studio Code automatically enter # at the start of a | What happens if I use two # 
new line after a comment? characters at the start of a 
Visual Studio Code automatically enters the # character when you press comment? 

(2153 with the insertion point inside a comment, breaking it to the next The first # character tells Python 4 
line, If this happens when the insertion point is apparently at the end of a_| the rest of the line is a comment, 
comment line, chances are that there is a space to the right of the insertion | so the second # character 

point that is causing Visual Studio Code to continue the comment. becomes part of the comment. 
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> File Edit Selection View Go Run Terminal Help 


dictionaries11 py - Visual Studio Code 


© dictionariest py x 


Dropbox > TYV_Python > Code > @ dictionariest1.py 


dishes = {} 
dishes["Starters"] = { 


“Garlic Bread” : 
“Spring Rolls” : 
"Soup of the Day" = 


"$3.00", 
"$4.50", 
"$2.50" 


} 
dishes[“Main Courses"] = { 
8", 


“pizza” : "$7.5 
“Lasagne” : "$10.00", 
“Bolognese” : "$5.50" 


} 
dishes["Desserts"] = { 


"Mousse" : “$4.08 
“Lemon Sorbet” = 
“Ice Cream” : 


$3.50", 


"$2.75" 


Epon 


Copyright (C) Microsoft Corporation. All rights reserved. 


= o x 
>b~ O- 
Mew. 
Ray 
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+~ Ox 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows 


PS C:\Users\guy> & "C:/Program Files/Python310/python.exe 
ionariesit.py 
Starters: 
Garlic Bread: $3.00 
Spring Rolls: $4.58 
Soup of the Day: $2.5@ 
PS C:\Users\guy> If 
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gag 54093401} . TNContainer00900900000000000001.regtrans-ms' 


MM ures', ‘PrintHood', ‘Recent', ‘Saved Games', ‘Searches 


BE Command Prompt pion XR = 8) 8 
Python 3.10.2 (tags/v3.10.2:a58ebec, Jan 17 2022, 14:1 
2:15) [MSC v.1929 64 bit (AMDG4)] on win32 
Type "help", "copyright", "credits" or “License” for m 
nfornation. 
mport os 
urrent = os.getcnd() 


= os. Listdir(current) 
> .sortQ 
>>> print(ff) 


['AppData', ‘Application Data', ‘Contacts, ‘Cookies’, 
‘Desktop’, ‘Documents’, ‘Downloads’, ‘Favorites’, ‘Li 
nks', ‘Local Settings’, ‘Music’, ‘My Documents’, ‘NTUS 
ER.DAT', 'NTUSER. DAT{d125c38d-88d4-11ec-a014-00155d003 
4O1}.TM.bLF', 'NTUSER.DAT{d125c38d-88d4-11ec-a914-0015 


1 'NTUSER. DAT{d125c38d-88d4-11ec—a014-00155d003401} .TM 
Containerde009009000000000002.regtrans-ms', ‘NetHood' , 
‘OneDrive', ‘OneDrive - First Informed Church', ‘Pict 


*, ‘SendTo', ‘Start Menu', ‘Templates’, ‘Videos', ‘ntu 
ser.dat.LOGL', ‘ntuser.dat.LOG2', ‘ntuser.ini'] 
>>> 


Boutouesaavga 


¢:/Users/guy/Dropbox/TYv_Python/Code/dict 


aeus muse 
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for item in collection: 
break statement 
statements 


Assign the next item 
from the collection 
to the variable 


Evaluate 
the break 
statement 


Is there 
another item 
in the 
collection? 


Execute the 
statements 


Code execution continues 


® name_generator x 


2 # This function returns a character name 
3 # by taking a first name from one list, 
4 # a middle initial from another list, 
5 # and a last name from a third list. 
6 first = ["Al", “Bo”, "Cy", "Dot", “Ed", “Em"] 
7 middle = ["A.", "B.", "C.", "D.", "E.", "F."] 
8 last = ["Adams", "Bain", "Col", "Dunn", "Ely"] 
‘ . | 
9 from random import choice 
10 cname = choice(first) 
11 cname = cname + “ " + choice(middle) 
12 cname = cname + " " + choice(last) 
13 return cname 
14 
15 for i in range(@,9): 
16 | print((generate_name())] 
PROBLEMS OUTPUT TERMINAL — DEBUG CONSOLE Dpytnon-gy +~ O @ ~*~ x 


quy@ 
Gy E. Ely 
Bo A. Dunn 


En D. Bain 
Gy E, Col 
guy@iac-Pro-3 ~ 0] 


Users > guy > Dropbox > TYV_Python > Code > ® name_generator 


1 def generate_name(): EE 


lac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/nane_generator 
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Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 

Type "help", "copyright", "credits" or "license" for more information. 
>>> ni = ["Sam", "George"] 


hapter 11 Working with Lists and Dictionaries 


>>> print(n1) 
['Sam', ‘George’ 
>>> n2 = ["Antonia”, "Brett"] 
>>> print(n2) 
['Antonia', 'Brett'] 

>>> ni.insert(1, "Helen") 
>>> print(n1) 
['Sam', 'Helen', 'George'] 
l>>> ni.extend(n2) 
>>> print(n1) 


['Sam', 'Helen', 'George', 'Antonia', 


sam@vubuntu: ~ 


'Brett'] 


>>> n1.append("Sia") 
>>> print(n1) 
['Sam', ‘Helen’, 


>>> quit() 


lsam@vubuntu:~$ 


George', 'Antonia', 'Brett', 'Sia'] 


classé 
@ classé 2 x pe O- 
Users > guy > Dropbox > TYV_Python > Code > Classes > @ class6 > ¢z BranchOffice > @ cm2ct 
1 class BranchOffice(): 
2 company = “CheeseWheat Associates" 
3 sector = "food science" 
4 @classmethod 
5 def showClassInfo(self): 
6 ci = self.company +", a" 
iz ci = ci + self.sector + " trendsetter" 
8 return ci 
9 def init__(self, city, street, state, zip, manager): 
10 self.city = city 
11 self.street = street 
12 self.state = state 7 
2B self.zip = zip 
4 self.manager = manager 
15 def getInfo(self): 
16 br = ( 
17 f"{self.city} Office\n\n" 
18 f"Manager: {self.manager}\n\n" 
19 f"{self.street}\n" 
20 f"{self.city}, {self.state} {self.zip}" 
21 ) 
22 return br 
23 @staticmethod 
24 def cm2cf(m3): 
25 
26 a = BranchOffice("Arcata", "442 Front", "CA", "95221-1111", “Aurora 
Smith") 
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CHAPTER 1 


Getting Ready 
to Work with 
Python 


In this chapter, you learn what Python is and get ready to work with it. 
You choose the version of Python that suits your needs and then install 
that version if your computer does not already have it. You also install and 
configure your main tool for working with Python, a powerful code editor/ 
integrated development environment called Visual Studio Code. 
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Understanding What Python Is and Does 


ython is a programming language that is used both widely and for many different purposes. 

Python enables you to write applications that work on many different computing platforms, 
including Microsoft Windows, Apple’s macOS, and Linux. Python is especially useful for automating 
routine tasks, thus enabling yourself and your colleagues to get more work done in less time. 


A Dutch programmer named Guido van Rossum began work on Python in the late 1980s, eventually 
releasing the first version as Python 0.9.0 in 1991. Since 2001, Python has been run by a U.S.-based 
nonprofit organization called the Python Software Foundation. 


Understanding What Python Is 


A programming language is a type of computer language that is used to implement algorithms, which are 
instructions for performing particular actions — in other words, to make the computer do what the 
programmer wants it to do. 


Python is a general-purpose programming language rather than a domain-specific programming language. 
As you might guess, a general-purpose programming language is a programming language designed for 
general programming use rather than for use in a specific area of computing. By contrast, a domain-specific 
programming language is a programming language designed for use in a specific area of computing. For 
example, Wolfram Mathematica is a programming language designed for symbolic mathematics; it is not 
designed for, and is not suitable for, general programming use, so it is domain specific. 


Understanding Cross-Platform Programming 


Python enables you to write applications that work on many different computing platforms. A computing 
platform means the hardware and operating system that together constitute a functional computer. 


This book covers three widely used computing platforms: 


PC hardware running Microsoft's Windows operating system. This book uses Windows 10 and 
Windows 11 for examples. 

Apple Macintosh hardware running Apple’s macOS operating system. This book uses macOS version 
12, also known as macOS Monterey, for examples. 

PC hardware running the Linux operating system. Linux comes in many different versions, called 
distributions. This book uses the popular Ubuntu distribution for Linux examples. 


Python fully supports the Windows, Mac, and Linux platforms, but it also supports many other platforms. 
These platforms range from those for personal devices, such as Apple’s i0S operating system and iPhones, 
all the way up to “big-iron” platforms for minicomputers and mainframes, such as IBM's AIX and HP’s 
HP-UX. Python versions for some platforms come from third-party vendors. 
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Understanding Who Uses Python 
Many different types of programmers use Python. Here are two examples: 


e Web developers use Python to create web services that provide custom information in response to 
requests they receive. For example, when you visit a web forum, Python may be generating some or all 
parts of the page that the server sends to your browser. 

Scientists, mathematicians, and engineers across many fields use Python to perform data analysis, 
because Python provides powerful and convenient tools for processing and applying complex equations 
to statistical data. 


Know Where You Can Get Python 


You can download Python for free from tmammnme = 
the Python Software Foundation’s € > _ & pythonorg/downioads/ 
website, www.python.org. However, you Python 

may not need to download Python, P é 
because it may already be installed on ; put on 
your computer. 


About Downloads Documentation Community Success Stories News Events 


Windows typically does not include Allreleases Yaa 
Python; see the section “Install Python sea | (iameee 
Windows 


on Windows,” later in this chapter, for Note that Python 3.9+ cannot be used on Windows 7 or 


Looking for Pythor aaa earlier. 


instructions on installing Python. ice eee ers 


Want to help test _ileltinaMaaetaiay | many operating systems and environments. 


macOS includes Python 2. See the ‘ooking or a 
section “Insta tL Python on the Mac,” Alternative Implementations 
later in this chapter, for instructions on 

: a : . Active Python Releases 
seeing which version a Mac contains and Fai nara ornishoa wai ByWOR inpars Gita 
updating Python if necessary. 


| View the full list of downloads. 


Many Linux distributions include one or more versions of Python. As of this writing, more distributions 
include Python 2 than include Python 3, but some distributions include both versions; see the following 
section, “Choose the Right Version of Python.” See the section “Install Python on Linux If Necessary,” later 
in this chapter, for instructions on checking the version and updating if necessary. 


To find versions of Python for iOS or iPadOS, open the App Store app on the iPhone or iPad and search for 
python. Pythonista is a popular app, but there are plenty of other choices. Similarly, to find versions of 
Python for Android, open the Play Store app on your Android device and search for python. 
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Choose the Right Version of Python 


s of this writing, two major versions of Python are in use: Python 2 and Python 3. Before you 

download and install Python on your computer, you should determine which version of Python 
will be best for your needs. This will most likely be Python 3, because Python 2 is out of date and 
the Python Software Foundation no longer supports it. 


This section explains what you need to know about Python 2 and Python 3. It also explains the two 
types of Python builds that are available — stable builds and development builds — and advises you 
which build type to get. 


Understanding Python 2 and Python 3 


Two major versions of Python are currently in wide use: Python 2, released in 2000, and Python 3, released 
in 2008. 


Each version uses a sequence-based numbering scheme for intermediate releases. For example, “Python 
2.7.1” means Python 2, the seventh minor version, and the first update to that minor version. Similarly, 
“Python 3.10.0” means Python 3, the tenth minor version, and the initial release of that minor version. 


The Python Software Foundation officially discontinued, or “sunset,” Python 2 on January 1, 2020. 
Sunsetting means that the Python Software Foundation will not develop Python 2 any further, even if 
researchers discover serious security issues in it. Because Python 2 has been sunset, the Python Software 
Foundation recommends that all users upgrade to Python 3 as soon as possible. The final version of Python 
2 was 2.7.18. 


With most software, such as business productivity apps or multimedia apps, upgrading to a newer version is 
a straightforward and painless procedure: You upgrade to the new version, and everything still works, even 
if the user interface has changed and the new version of the app provides extra features. 


Python 3 offers compelling new features that Python 2 does not have; even better, Python 3 typically runs 
faster than Python 2. However, Python 3 is not fully compatible with Python 2, and some Python 2 code 
may not run successfully in Python 3. This is why many companies and organizations still have not upgraded 
from Python 2 to Python 3. The more Python 2 code a company or organization has built up, the more time, 
effort, and expense it will take to upgrade to Python 3. 


Which Version of Python Do You Need? 


You almost certainly need Python 3 unless your workplace uses Python 2 and is not migrating to Python 3. 
For example, your employer may have developed substantial amounts of Python 2 code that is not fully 
compatible with Python 3 and may therefore be sticking with Python 2. 
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If you are planning to start developing code from scratch, you should definitely choose Python 3 rather 
than Python 2. 


You can install both Python 2 and Python 3 alongside each other and use each version when you need it. 


macOS and many Linux distributions include Python 2 because they require Python 2 to run some software 
packages included with the operating system or distribution. Because of this requirement, you should not 
uninstall Python 2, even if you do not need it. Instead, simply leave Python 2 alone, install Python 3, and 
use Python 3 for development. 


Windows does not need Python 2, so normally, you should install Python 2 on Windows only if you need it. 


What Are the Two Build Types of Python? 
Python.org makes available two types of builds of Python, stable builds and development builds: 


Stable build. A stable build is a build that has been fully tested and approved for distribution. 


Development build. A development build is an experimental build used for testing and compatibility. 
Development testers provide feedback on changes and new features before they are finalized and added to 
stable builds. 


You may also see Python builds described as “release candidates.” A release candidate is a near-final 
development build made available — usually to a wide audience — for final testing. A release candidate is 
stable in theory but not always so in practice. 


Which Build Type Should You Get? 


You will almost always want to get a stable build of Python rather than a development build. Normally, you 
will want to get the latest stable build of Python so that you have access to the latest features. However, if 
your company, organization, or school is using an older stable build of Python, it will likely want you to use 
that build for compatibility. 


When Will Python 4 Be Released? 


The Python Software Foundation has not announced a release date for Python 4. In fact, Guido van Rossum 
has cast doubt on whether there will ever be Python 4, given how difficult and protracted the move from 
Python 2 to Python 3 turned out to be. Instead, the Python Software Foundation is continuing to develop 
Python 3. 


As of this writing, the current stable version of Python is 3.10.4. Future versions of Python 3 are likely to 
use numbering such as 3.11.x, 3.12.x, and so on. 
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indows has no version of Python installed by default, so you will need to install Python unless 
you have already installed it or an administrator has installed it for you. 


You can install Python either by using the Microsoft Store app or by downloading and running the 
Python installer from the Python Software Foundation. Microsoft recommends using the Microsoft 
Store app, but we recommend downloading the Python installer, because this enables you to make 
the latest version of Python available to the Visual Studio Code editor app, which you will meet later 
in this chapter. 


Install Python on Windows 


Download and Install Python on 
Windows 


@ Open a browser window and go to the 


Python Software Foundation website, . a | 
www. python.org. 


Downloads 2 ventation Community Success Stories News Events 


2) Hold the pointer over Downloads. Aces 
Download for Windows 
é Cae Source code 
A pop-up window appears. >= Subensins 
7 Note that Python 3.9+ cannot be used on Windows 7 or 
The web page selects the Windows tab, — ee ee eee 
. . Other Platforms many operating systems and environments. 
because it detects your computer is — ie ieee 
running Windows. a gril REE 


© Click the Python button under the Reiner seedy) EY) see SUL SS one ey) 
D [ d f, Wi d h di and integrate systems more effectively. »»» Learn More 
ownload Tor Windows heading. 


This button shows the Python version, 
such as Python 3.10.0 in the example. 


® Welcome to Python.org 


€ C @ pythonorg 


The browser downloads the file. 


Python 


@ python’ . a © 


4 ) Open the downloaded file from the About Downloads Documentation Community Success Stories News Events 
browser. For example, in Chrome, click 
Actions (A changes to \) to open the 
pop-up menu, and then click Open to 
open the file. 


Note: In Microsoft Edge, click Downloads (1) zi "hee 
to display the Downloads panel, locate the ————— 
Python file you downloaded, and then click 
Open file beneath its name. 


ng language that lets you work quickly 


& python-3.10.0-am...exe | ¥ 4 Showall | X 
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The Python Setup Wizard opens and [E> Python 3.10.0 (64-bit) Setup = Xx 


displays the Install Python screen. Install Python 3.10.0 (64-bit) 
@ Select Install launcher for all users (@) ot eatin eich yee en oat ies ee 
to install the Python launcher for all users 


: Sa ®@ Install Now 
of this computer. This 1S usually helpful. Cee guAppDstaLocah rogram Python\Pthons10 <Q 
Note: If an earlier version of Python is a Reet AS eas ecieneeees 
installed on the PC, the Upgrade Now button 


appears. See the subsection “Upgrade Python > Customize installation <a 
. " . . . Choose location and features 
on Windows,” later in this section. 


@ Select Add Python to PATH (@) to add python 
the location of the Python executable file | windgws 


~ @ Install launcher for all users (recommended) ~<f) 


Add Python 3.10 to PATH Cancel 
to your Windows PATH statement. Doing 
so enables Windows to find Python and is _  Pvthen3:10.0 64-bit) setup - me 
usually helpful. ) Optional Features 
@ You can click Install Now to install ——— 


Installs the Python documentation file. 


Gpip 


yourself, not for other users. Installs pip, which can download and install other Python packages. 
. oe , O td/tk and 8 ) 
@ Click Customize installation. 


Python and all its components for 


Installs tkinter and the IDLE development environment. 


: @ Python test suite 
The Optional Featu res screen appears. Installs the standard library test suite. 


© Deselect the check box for any feature 
you do not want to install. For example, pyth I 
deselect tcl/tk and IDLE ((_)) if you do eee 
O- Next 


@ py launcher @ for all users (requires elevation) 


Installs the global ‘py’ launcher to make it easier to start Python. 


Cancel 


windows Back 


not want to install the IDLE development 
environment. 


9) Click Next. 


TIP 


Which apps does the Python installation include? 

The Python installation installs an app called Python — for example, Python 3.10 — and an app called 
IDLE, an integrated development environment for Python. The IDLE app’s name includes the version of 
Python, such as IDLE (Python 3.10). 


You can use the IDLE integrated development environment to create and test Python code, but we 
recommend you use Visual Studio Code instead, because it provides more features and is widely used. See 
the section “Download and Install Visual Studio Code,” later in this chapter, for information on getting 
Visual Studio Code. 


continued 
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Install Python on Windows (continued) 


hen installing Python, you can choose to install the Python launcher component for just 

yourself or for all users. Separately, you can choose to install the main Python app and other 
components either for just yourself or for all users of your computer. You can also add the Python 
program location to your Windows PATH, which enables Windows to find Python without you having 


to specify the path explicitly. 


After installing Python, you can update it to the latest version by downloading the latest installer 


from the Python Software Foundation website, running the installer, and clicking Upgrade. 


Install Python on Windows (continued) 


Download and Install Python 
on Windows (continued) 


The Advanced Options screen 
appears. 


Note: By default, the Python Setup 
Wizard installs Python and the 
components you choose only for you, 
not for all users of your computer. 


@ The default install location is 
within the AppData folder in your 
user account. This location is 
available only to you. 


(10) Click Install for all users 
(C) changes to @). 


@ The install location changes to a 
Python folder within your 
computer's Program Files folder. 
This location is available to all 
users. 


@ You can click Browse and select a 
different install location if 
necessary. Normally, the default 
location works well. 


(11) Click Install. 
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I Python 3.10.0 (64-bit) Setup 


Advanced Options 
Install for all users 
@ Associate files with Python (requires the py launcher) 
@ Create shortcuts for installed applications 
@ Add Python to environment variables 
@ Precompile standard library 
O Download debugging symbols 
O Download debug binaries (requires VS 2017 or later) 


Customize install location 
C:\Users\guy\AppData\Local\Programs\Python\Python310 


You will require write permis; s for the selected location. 


Back @ install 


Browse 


Cancel 


I Python 3.10.0 (64-bit) Setup 


Advanced Options 

@ Install for all users 

@ Associate files with Python (requires the py launcher) 
@ Create shortcuts for installed applications 

@ Add Python to environment variables 

@ Precompile standard library 

© Download debugging symbols 

O Download debug binaries (requires VS 2017 or later) 


Customize install location 
C:\Program Files\Python310 


Back 


> oiss:a1 


Browse  F] 


Cancel 
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Note: If the User Account Control dialog box [& Python 3.10.0 (64-bit) Setup = x 
opens, prompting you to decide whether to 
allow the Python Setup Wizard to make 

changes to your computer, click Yes. New to Python? Start with the online tutorial and 


documentation. At your terminal, type “py” to launch Python, 


Setup was successful 


or search for Python in your Start menu. 


The Python Setup Wizard installs the 
com onents ou chose See what's new in this release, or find more info about using 
Pp y . Python on Windows. 


The Setup Was Successful screen appears. 


® If you want to disable the path length 7 Debi pth neh ik GE programs, including Python, to 
limit, click Disable path length limit, and Sa aio 
then click Yes in the User Account Control 
dialog box that appears. 


> Close 


® Click Close. I Python 3.9.7 (64-bit) Setup - x 
The Python Setup Wizard closes. ) Upgrade to Python 3.9.7 (64-bit) 
Upgrade Python on Windows epee aaa or choose Customize to 


installer for the latest version of Python aa 
from the Python Software Foundation 

website, www.python.org, and open the 
installer file. 


@ Follow steps 1 to 4 in the previous @ Upgrade Now Ee) 
subsection to download the Windows 4 sii sanaaatiae iia 


— Customize installation 
Choose location and features eG) 
The Python Setup Wizard screen appears. 


e Click Upgrade Now to upgrade Python but 
retain all your settings. 


| Cancel | 


@ If you want to change your settings, click Customize installation, and then make your choices on the 
Options screen and the Advanced Options screen. 


TIP 


What is the path length limit, and should I disable it? 

The Windows path is a text variable that tells Windows where to find important items. For example, 
PATH=C: \Windows;C:\Program Files tells Windows where to find the Windows folder and the Program 
Files folder. Selecting Add Python to PATH (@) adds Python’s folder to the path, so Windows can find 
Python without you having to specify the folder. 


The PATH variable has a length limit of 260 characters for backward compatibility with older versions of 
Windows. However, this limit may cause errors when compiling and running Python code that uses long 
paths. Normally, you should click Disable path length limit on the Setup Was Successful screen to disable 
the path length limit. 
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Install Python on the Mac 


hether it has an Intel CPU or an Apple Silicon CPU, your Mac almost certainly has a version of 
Python installed — but it is most likely to have only Python 2. If so, you will want to install 
Python 3, probably the latest stable version of it. 


In this section, you use the Terminal app in macOS to check whether Python is installed and, if so, 
which version. Then, if needed, you can download and install a newer version of Python. 


Install Python on the Mac 


Check Which Version of Python Is 
Installed on Your Mac 


@ Click Launchpad (#2). 
Launchpad opens. 
@ Start typing terminal. 


Launchpad narrows the selection to the 
apps that include what you have typed. 


© Click Terminal (@). 


A Terminal window opens. 


Launchpad 


4 Type python3 and press Return } @ install Command Line Developer Tools 
Note: If Terminal displays the version of Last login: Fri Apr 16 18:11:45 Qo” 


maria@Marias—Mac ~ % python3 


Python, as shown in the final screen of this |xcode-select: note: no developer®0ols were found at '/Applications/Xcode.app', 
requesting install. Choose an option in the dialog to download the command line 


section, go to step 8. Python 3 is already developer tools. 
a maria@Marias—Mac ~ % | 
installed on your Mac. 


A} A di a log box 0 pen S, p ie) m pti n g yo u to Go The “python3” command requires the command line 
install the command-line developer (al See ee ae eee eee ae 
too Is . -- Chaves inetel te downland and install the command line 


@ Click Install. L == & 


The Downloading Software dialog box 
opens, showing a progress readout. ml Downloading software 


About 20 seconds remaining 


Stop 
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When the installation completes, a Install Command Line Developer Tools = 
The Software Was Installed dialog box |°°® i maria —-zsh— 80x24 
Last login: Fri Apr 16 18:11:45 on ttys@e0 iS 
opens. maria@Marias-Mac ~ % python3 ] 
xcode-select: note: no developer tools were found at '/Applications/Xcode.app', 
6) Click Done requesting install. Choose an option in the dialog to download the command line 
. developer tools. 


maria@Marias—Mac ~ % || 


w The software was installed. 


The dialog box closes. Terminal Shell Edit View Window Help = 
7 ‘ eee > maria — Python — 80x24 
The Terminal window becomes Last login: Fri Apr 16 18:11:45 on ttys0ee a 
: : maria@Marias—Mac ~ % python3 ] 
active again. xcode-select: note: no developer tools were found at '/Applications/Xcode.app', 


requesting install. Choose an option in the dialog to download the command line 
developer tools. 
@ Type python3 and press Return § maria@Marias—Mac ~ % pythons af } 
CGC 1 2628, 15:06:04) 


ython 3.8.2 (default, Dec 2 
@ The version of Python appears. [Clang 12.0.0 (clang-1200.0.32.29)] on darwin 
© Type quit() or press G+. 


Type "help", "copyright", "credits" or "license" for more information. 
The Python app quits. 


>>> 
9 ) Press &3+@). 


The Terminal app quits, and the 
Terminal window closes. 


TIP 


How can I update the version of Python on my Mac? 
The easiest way to update the version of Python on your Mac is to download the latest Python installer file 
for macOS from the Python Software Foundation website, www.python.org; run the installer; and click 


Upgrade Now. 


On a Mac that you administer yourself, another option is to install the Homebrew package manager, which 
you can download for free from the Homebrew website, https://brew.sh. After installing Homebrew, you can 
quickly update Python by opening the Terminal app and running the appropriate command. 
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any Linux distributions include a version of Python, so you may not need to install Python on 

Linux. In this section, you check whether Python is already installed on your Linux box and 
install it if it is not. If Python is already installed but is out of date, you update it to the latest 
version available for your Linux distribution. 


This section uses Ubuntu Linux as the example and provides brief notes on other widely used Linux 
distributions. You need to have the permission to run commands as superuser — as the root user — 
using the sudo command. 


Install Python on Linux If Necessary 


Verify That Python Is Installed on Linux 


@ Open a Terminal window. For example, on 
Ubuntu: 


Click Show Applications (FR). 


2 


The Activities screen appears. 


Type terminal. 


% 
a 
2) 
B 
A 
@ 


Matching search results appear. 


Click Terminal (@ or similar). 


A Terminal window opens. 


@ Type python3 and press GTSD. 


If Terminal displays details of the Python 
version, such as Python 3.9.5, Python is 
installed. 


m ted@UbuntuPi: ~ Qa\= - o @ 


-$ a 2) 


You can quit Python by typing quit() and 
pressing (je). Alternatively, press (ij) 


Note: If you see a message saying that Python was 
not found, you need to install Python. In the 
Terminal window, type sudo apt install python3 buntuPt:-§ pythons 
a =) Python 3.9.5 (default, May 11 2021, 08:20:37) 
and press (G3. If Terminal prompts you for your sllCUS mele wtopyrtght”, “credits” or “Lcense” for nore tnfornatton. 
% . een >>> quit( 
password, type it and press (=). Linux then (| 


A ted@ubuntuPi: ~ a}= - co © 


downloads and installs Python. 
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Update Python on Linux 
@ Open a Terminal window. For example, 


‘ ‘ - my parallels@vubuntu: ~ 
on Ubuntu, click Show Applications Eeyparallels@vubuntu:~$ sudo apt update 
° . sudo] password for parallels: 
(:: type terminal, and then click [ SaHit:1 http://us.archive.ubuntu.com/ubuntu focal InRelease 
maHit:2 ht security.ubuntu.com/ubuntu focal-security InRelease 
Te = l on Hit:3 ht us.archive.ubuntu.com/ubuntu focal-updates InRelease 
ermina (@). Hit:4 http://us.archive.ubuntu.com/ubuntu focal-backports InRelease 


Reading package lists... Done 
Building dependency tree 


@ Type the sudo apt update [er ipstingemrcon Barengysiadl hen Soil Uuhetiaesitiila® havens Bhai 
lparallels@vubuntu:~§ sudo apt upgrad 
command and press (ae). . 4) 


Linux prompts you for your password. 


© Type your password and press GSD. 


Linux downloads the latest list of 
software packages available. 


@ Terminal displays information about 
available upgrades. 


4 Type the sudo apt upgrade 
command and press Gia. Aly parallels@vubuntu: ~ a|= - 3 @ 


Installing new version of config file /etc/cron.weekly/update-notifier-common .. 
Note: If Terminal displays information about  [erting up update-notifier (3.192.30.9) ... 


tt7 + . Setting up update-manager (1:20.04.10.7) ... 
the amount of additional disk space that will Processing triggers for systemd (245.4-4ubuntu3.11) ... 


7 Processing triggers for man-db (2.9.1-1) ... 
be used and prompts you to decide whether Processing triggers for cracklib-runtime (2.9.6-3.2) ... 


to continue, type y and press Enter } Processing triggers for plymouth-theme-ubuntu-text (0.9.4git20200323-Oubuntu6.2) 
J " lupdate-initranfs: deferring update (trigger activated) 
Linux downloads and installs the Processing triggers for dbus (1.12.16-2ubuntu2.1) ... 
Processing triggers for shared-mime-info (1.15-1) ... 
updates. Processing triggers for install-info (6.7.0.dfsg.2-5) ... 


Processing triggers for fontconfig (2.13.1-2ubuntu3) ... 


ss Processing triggers for desktop-file-utils (0.24-1ubuntu3) ... 
@ When the upgrade finishes, the prompt Processing triggers for mime-support (3.64ubuntu1) ... 


Processing triggers for hicolor-icon-theme (0.17-2) ... 
reappears. Processing triggers for gnome-menus (3.36.0-1ubuntu1) ... 
Processing triggers for libc-bin (2.31-Qubuntu9.2) ... 


Processing triggers for initramfs-tools (0.136ubuntu6.6) ... 
You can then type python3 and press lupdate-initramfs: Generat /boot/initrd.img-5.11.0-34-generic 
(2553 to see the Python version that parallels@vubuntu:~$ eG) 


has been installed. | 


How do I install Python on other Linux distributions? 
Generally, you would install Python from your distribution’s application repository. 


Here are the commands for other popular distributions: 
e Fedora: sudo dnf install python3 


e Arch: sudo pacman -S python3 


SUSE: sudo rpm install python3 
Other Debian-based distributions: sudo apt install python3 


0005377492.INDD 15 Trim size: 7.375 in x 9.25 in July 1, 2022 2:33 PM 


Learn About Development Tools for Python 


ython code consists of plain text with structured layout, so you can create the code in any app 
that can output plain text. For example, you can create Python code in the Notepad text editor 
on Windows or in the TextEdit text editor on macOS. 


But unless you like doing things the hard way, you will be better off using an app that is designed 
for creating code and that provides features to help you create code that is both correct and 
correctly formatted. This app can be either a code editor or an integrated development environment, 
IDE for short. 


ferences Help 


What Is a Code Editor? Ell cAUsers\Guy\Dropbox\TWV_Python\Code\Fahrenheit py aliiblime Text 
A code editor is an app that File Edit Selection Find Jf Goto Tools rene 
is designed and built to OPEN FILES Assessmentl xX | Integers 1.py x Fahrenheitl.py x Background_Ops x + ¥ 


orca Assessment! def degreesFToC(fahrenheit): 
make the wniting of * Integers_l.py 2 celsius = fahrenheit - 32 


programming code easier, x Fahrenheit1.py 3 celsius = celsius * 5 

faster, and more efficient. = Racin Cre ae = eee to 

While you can write code print("xf F is xf C" \ 
using any text editor or word Sena omen 
processor, these apps do not A el con es 

provide the programming- degreesFToC(32) 

specific features that a eis teiaiidha uae 


code editor gives you. main() 


A code editor typically 
includes features such as 


the following: 


e Syntax evaluation and 
highlighting. As you 
program, the editor de- 
termines the code’s different elements and highlights them in different colors and font styles (A) to help 
you identify them visually. 

Automatic completion of code. When you start typing a keyword or another known element, the code 
editor displays suggestions for completing it. By accepting these suggestions, you can work faster. 
Multifile interface. Whereas most word processors keep each document in a separate window, many 
code editors use a tabbed interface (B) that enables you to open multiple files in the same window and 
switch quickly from one file to another by clicking the appropriate tab. Many text editors likewise use a 
tabbed interface. 

Line numbers. The code editor automatically displays line numbers (C) so that you can easily navigate 
through your code. 


© Line 1, Column 1 
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What Is an Integrated File Edit View Navigate Code Refactor Run Tools VCS Window Help __ fileProcessor - testing.py = oOo x 
Development fleProcessor iG testing. py B- tating GS GM QHD 
Environment? fs He aon a ste dee iG testing.py 


= > Bi venv lib 


An integrated development i maingy 

environment, or IDE, is an or def main(): 

a a a 2a sommes str_file = input("Enter the file parameter: ") 
application designed for Mo Scratches and Consoles print(str_fite) <2 
developing code. The nain() 

development environment is 
integrated because you can 
both write the code in the Pan 

environment and run the hee ets aie 


: ¢ C:\Users\Guy\PycharmProjects\fileProcessor\venv\Scripts\python.exe C:/Users/Guy/PycharmProjects| 
code to make sure it works Enter the file parameter: post-industry 
correctly. 


<@ 


S= Structure 


An IDE typically provides 
similar features to those in 

a code editor, such as syntax 
evaluation and highlighting, 
automatic code completion, 
and the ability to switch easily among multiple files. To these features the IDE adds tools for testing and 
debugging your code. 


¥ 
rT] 
+ 


>, Run 


eg ie dl 


2% Favorites 


f2TODO @ Problems # Debug Terminal = Python Packages ® Python Console Q Event Log 
2:40 CRLF UTF-8 4spaces Python 3.9 (fileProcessor) ‘ta 


O 


For example, the figure shows the PyCharm IDE. In the upper-left corner is the Project pane (D), which 
enables you to navigate among the files in your current project; gives you access to external libraries, 
repositories containing code you can add; and provides a scratch window for quick work and notes, and 
consoles for running code outside the IDE. In the upper-right corner is the Code pane (E), where you write 
your code. And across the bottom is the Run window (F), in which the output from your running code 
appears. 


Should I Use a Code Editor, an IDE, or Both? 

Which coding tools you use for Python is very much a personal preference. That said, you will almost 
certainly want to use an IDE for debugging your Python code. The question then becomes whether you want 
to use a code editor as well as an IDE. 


You may want to use both a code editor and an IDE for different aspects of your work developing code in 
Python. Experiment with different tools to discover which tool or combination of tools works best for you. 


continued 
17 
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Learn About Development Tools for Python (continued) 


hen it comes to development tools for Python, there are a lot of choices. Many Python-capable 

code editors and IDEs are available, offering various combinations of features likely to appeal 
to different developers. Most of these code editors and IDEs work for multiple — or many — 
programming languages, but you can find IDEs built to work only with Python. 


This section introduces you to some of the code editors and IDEs you may want to explore, including 
Visual Studio Code, the coding tool we recommend you use for working with Python. 


Which IDEs Can I Use for Creating 
Python Code? 


You can use a bewildering variety of IDEs for creating medina" 
Python code. Some IDEs are designed for use only with encarta Es se 
Python, whereas other IDEs are designed for use with haa 
various programming languages. Some IDEs are much 
fuller featured than others and provide more help as you 
work. Extra help may be welcome while you are starting 
to use Python but may become annoying as you gain more 
experience. 


Here are three examples of IDEs for Python: 


os AW 
str current folder ‘C\\\\Users\\\G..re-Production’ 


e IDLE. IDLE is a minimalist IDE that is included in the Th Thonny - C:\Users\Guy\Dropbox\TYV_Python\Code\integers_11.py @ ... 
File Edit View Run Tools Help 
Python packages you can download from the Python mane ~ 
Software Foundation website, www.python.org. IDLE, ren thay 
shown in the figure, uses multiple separate windows J strN1 = input ("Enter an integer: ") 


strN2 = input("Enter another integer: ") 


for the Editor (G), the Shell (H), and features such as intN1 = int (strN1) 


4 intN2 = int(strN2) 


Debug Control (1) rather than displaying multiple panes einen pre einer 

inside a single window. 7 print(strN1 + "+" + strN2 + "=" + strTotal) 
PyCharm. PyCharm (www.jetbrains.com/pycharm) is a 
full-featured IDE that comes in two editions. Normally, 
you would want the Community Edition, which is free 
and works only with Python. The other edition, Profes- Sabet an: Anteger® 425 
sional, is a paid version that has a free trial and works ee ee ee 
with HTML, JavaScript, and SQL, as well as Python. >>> 

Thonny. Thonny (https://thonny.org) is a lightweight 
IDE designed to help beginners come to grips with 
Python coding. Thonny offers three modes for different levels of experience: Simple Mode for beginners, 
Regular Mode for those who need greater control, and Expert Mode for advanced users. The accompany- 


ing figure shows Regular Mode. 


Python 3.7.9 
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Which Code Editors Can I Use for Fahrenheit] py — CAUsers\Guy\Dropbox\TWV_Python\Code— Atom 
Python? aac: cme 


You have a wide choice of code editors 
suitable for programming Python. Here 
are three examples of code editors well 
worth your consideration: 


 Fahrenheit1.py 


e Sublime Text. Sublime Text, shown 
in the “What Is a Code Editor?” sub- 
section earlier in this section, is a 
powerful text editor with a minimal- 
ist interface that provides as much 
space as possible for displaying your 
code files. Sublime Text supports 
more than 40 other programming 
languages as well as Python. You 
can download an evaluation version 
of the app from the Sublime Text website, www.sublimetext.com; the app then costs $99 for a 3-year 
subscription. 
Atom. Atom, shown on this page, is a highly customizable code editor that makes working with multiple 
files easy. As of this writing, Atom seems to place greater demands on the computer running it than the 
other code editors listed here; as a result, Atom tends to run more slowly. Atom is free to download from 
the Atom website, https://atom.io. 
Visual Studio Code. Visual Studio Code is a powerful code editor developed by Microsoft. It is separate 
from Microsoft's Visual Studio IDE and runs on Windows, macOS, and Linux. See the following section for 
more information. 


Which Code Editor or IDE Does This Book Recommend for Python? 

This book recommends that you use Visual Studio Code as your main coding tool for working with Python, at 
least while using this book. Visual Studio Code is free, provides powerful coding features, and is widely used 
for various programming languages from C++ and C# to PHP and PowerShell. 


While Visual Studio Code is generally described as a code editor, it also provides full-scale debugging 
features, so it is effectively also an IDE. 


The following section, “Download and Install Visual Studio Code,” shows you how to get the app on your 
Windows PC, Mac, or Linux box. Subsequent sections show you how to set Visual Studio Code’s look by 
applying a theme, install Python-related extensions to provide extra functionality, and configure some 
essential settings. 
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Download and Install Visual Studio Code 


bs this section, you download and install the Visual Studio Code app. Visual Studio Code is the 
code editor and IDE we recommend you use for creating Python code. Visual Studio Code runs 
on Windows, macOS, and Linux; this section shows Windows and provides notes and tips on the 


differences in macOS and Linux. 


On Windows, you can add an Open with Code command to the context menus for files and for 
directories. This command enables you to easily open a file or a folder in Visual Studio Code from File 


Explorer, which is usually helpful. 


Download and Install Visual Studio Code 


@ Open your web browser and go to https:// 
code.visualstudio.com. 


The home page of the Visual Studio Code 
website appears. 


@ Click the Download link for your computer's 
operating system. 


@ The Download button shows the operating 
system your computer is using. 


@ To download Visual Studio Code for another 
operating system, click the drop-down arrow 
(i), and then click Download (L) in the 
Stable column for the operating system. 


The Documentation for Visual Studio Code 
screen appears, and the download starts. 


3 ) Launch the Setup Wizard. For example, in the 
Chrome browser, click A (A changes to Hl), 
and then click Open on the pop-up menu. 


The Setup Wizard’s License Agreement screen 
appears. 


@ Read the license agreement. 


@ If you want to continue, click I accept the 
agreement (© changes to @). 


6 } Click Next. 


2 


24) Visual Studio Code -Code Editin x of 


Visual Studio Code 


Code editing. 
Redefined. 
iton of 


Download for Windows B 
Stat id 


4 Download 


24) Documentation for Visual Studio xo 


& C  @@ code.visu; 24 setup - Microsoft Visual Studio Code (User) = x 


Visual Studio Coq 


Overview | 


License Agreement 
Please read the folowing important information before continuing. 


Please read the following License Agreement. You must accept the terms ofthis agreement before 
continuing with the instalation. 


the Visual Studio Code product. Source Code for Visual 
le at hitps://github.com/Microsoft/vscode under the MIT 


setup 


Istudio.com/do 


fic 
GET STARTED | https://code. 


MICROSOFT SOFTWARE LICENSE renns <Q) 


ipporting/taq. 


User GUIDE q 
LANGUAGES i 
MICROSOFT VISUAL STUDIO CODE 
NoDEs5/ 
JAVASCRIPT 
accep the agreement 

Typescaiet 1 Ordortanpt heapecment 

. lar 
PYTHON A 6 _ 
Java 
ess 
CONTAINERS \ 


DATA SCIENCE Show in folder 


Cancel 


24) vscodeUserSetup....exe 


= 


xy 8 2: 


GETTING STARTED 


Show all X 


@ Click Next on the Select Destination Location screen. 


8) Click Next on the Select Start Menu Folder screen. 
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The Select Additional Tasks screen appears. 2) Setup - Microsoft Visual Studio Code (Use) - x 
@ Select Create a desktop icon (@) if you want a Visual eee <j 
Studio Code icon on your desktop. me 
Select Add “Open with Code” action to Windows ea 9) 
Explorer file context menu (@), as needed. 10 ehadeteteneenasapaamiate 11 
€@) Select Add “Open with Code” action to Windows orcteraneentaten 2) 
Explorer directory context menu (@), as needed. pS 


® Select Register Code as an editor for supported file 
types (@) to associate Visual Studio Code with the file 


types it supports. ee 145 


24 Setup - Microsoft Visual Studio Code (User) - x 


@® Select Add to PATH (@) to add Visual Studio Code to your exe 4) 
Windows path. This helps Windows locate Visual Studio Code. ee nee e ee ee 


Click Install to continue with the installation, or dick Back if you want to review or change any settings. 


14) Click Next. en 


C:\Users\guy \AppData \Local Programs \Microsoft VS Code 


The Ready to Install screen appears. Gabe 
© Verify that the summary shows the choices you intended to Mieoamieresarcas 


make. 


@ If you need to make changes, click Back until you reach the 
appropriate screen. 


16) Click Install. e- 


The Setup Wizard installs Visual Studio Code. 17) Click Finish. 
The Completing the Visual Studio Code Setup Wizard screen The Setup Wizard closes. 
appears. 


Visual Studio Code opens. 
Note: If you want to use Visual Studio Code immediately, select 


Launch Visual Studio Code (@) on the Completing the Visual You can now configure Visual Studio 


Studio Code Setup Wizard screen. Code, as explained in the section 
“Configure Visual Studio Code for Working 


with Python,” later in this chapter. 


How do I install Visual Studio Code on macOS? How do I install Visual Studio Code on Linux? 
Download the latest Mac Universal Stable Build from Go to https://code.visualstudio.com and download 
https://code.visualstudio.com. Double-click the the appropriate installer package for your 


downloaded zip file to extract its contents, the Visual distribution — for example, the Debian installer 
Studio Code app. Drag this app to the Applications package or the Red Hat Package Manager installer 
folder. You can then delete the downloaded zip file. package. Open the file and follow the prompts. 
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he first time you run Visual Studio Code, the app displays the Get Started with Visual Studio 

Code screen, which walks you through some initial configuration steps. You can return to the Get 
Started with Visual Studio Code screen later if you like; alternatively, you can use the app’s other 
means of accessing its settings to configure the app to work the way you prefer. 


The first change you will likely want to make is to the theme, which controls the overall Look of 
Visual Studio Code. The app includes various dark themes and various light themes; third-party 
themes are also available. 


Get Started with Visual Studio Code and Apply a Theme 


Launch Visual Studio Code 


@ Launch Visual Studio Code in one of 
the standard ways for your computer's 
operating system. 


Get Started with VS Code <Q 
ant B 


For example, on Windows, click Start 
(G4) to open the Start menu, and then 
click Visual Studio Code (fH). 


The Get Started with Visual Studio Code 
screen appears. 


BB 
Light 


The list on the left contains headings for 
several initial configuration steps. 


2] Click Choose the look you want. 
Controls under the heading section appear. TPz omnes Cmaat> 
A preview appears. 

3) Click Browse Color Themes. 
The Theme drop-down list opens. 
The highlight shows the current theme. 


The Light Themes section at the top 
contains themes based on light colors. 


The Dark Themes section contains themes 
based on dark colors. 


@ Press @ or G to move the highlight to 
the theme you want to preview. 
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Visual Studio Code displays a 
preview of the theme. 


@ Click the theme you want to apply. 


Note: You can also press Gy to 
apply the currently selected theme. 


The Get Started screen appears 
fully again. 


@ Click the next heading whose 
settings you want to explore. 


@ The settings for the heading 
appear, and you can work with 
them. 


@ When you finish working through 
the list, you can click Mark Done 
(7) to tell Visual Studio Code you 
finish using this list. 


How do I go back to the Getting Started 
screen? 
Click Help to open the Help menu, and then 


click Getting Started. On the screen that 
appears, click Get Started with Visual Studio 
Code in the Getting Started list on the right. 
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x) File Edit Selection view 


>) Get Started x 


J File Edit Selection View Go Run Terminal Help 


>) Get Started x Oo - 


CH Mark Done 
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Go Run Terminal Help Get Started - Visual Studio Code - o x 


Select Color Theme (Up/Dowp xeys ti 


Light (Visual Studio) 
Light+ (default light) 
Quiet Light 
Solarized Light 


light themes 
< Get Started 


Ge 
? Dise 
VvS¢ 


Abyss 

Dark (Visual Studio) 
Dark+ (default dark) 
Kimbie Dark 

© Cho ronokai 

Monokai Dimmed 
Red 


dark themes. 


Then 
your: 
simpl 


Solarized Dark 


Dark 


-) Sync to and from other devices 


High Contrast 
-) One shortcut to access everything See More Themes... 


> Rich support for alll your languages 


> Open up your code 


w Mark Done Next Section + 


Get Started - Visual Studio Code = ia) x 


< Get Started 


© Choose the look you want 


O Sync to and from other devices: 


Keep your essential VS Code 
customizations backed up and updated 
‘across all your devices. 


Enable Settings Sync 


z= | E=| 


>) One shortcut to access everything 


>) Rich support for all your languages 


>) Open up your code 


Next Section + 


Why does Visual Studio Code have so many dark 
themes? 

Dark-hued themes tend to be easier on the eye, especially 
when you are coding for a long time in a dimly lit room. 
By contrast, this book uses a light-hued theme to increase 
readability on both the printed page and the screen. 
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Install Visual Studio Code Extensions for Python 


isual Studio Code comes with powerful built-in features, but it also enables you to add further 

functionality by installing extensions. An extension is an add-on unit of code that you can install 
or uninstall separately. Many extensions are available from third-party developers, providing a wide 
range of supplementary functionality for Visual Studio Code. 


For working with Python, you should install the Python extension, as explained in this section. The 
Python extension includes the Pylance server language extension and the Jupiter Notebook Renderers 
extension, so you effectively install three extensions in a single move. 


Install Visual Studio Code Extensions for Python 


@ Launch Visual Studio Code in one of the 
ways your computer's operating system 


J File Edit Selection View Go Run Terminal Help Visual Studio Code - o x 


EXTENSIONS yo 


Search Extensio\ 


offers. > mnstaLeD 
~ rorutan on 
For example, on macOS, click Launchpad @ wes a, 


* 


(#:) to display the Launchpad screen, 


y C/C++ 
C/C++ Intellisense, debugging, and co ate 
Microsof ft 


— 

and then click Visual Studio Code (MH). F< ore so 8 
2 o earners support, interactive progr 

Visual Studio Code opens. @ irrrestsinc oases case 
Dirk Baeumer ‘= 


Pylance 168M 3. 
A performant, feature-rich language server = 


Prettier -Code formatter <1 
Code formatter using prettier 


Prettier 


@ Click Extensions (i). 


The Extensions screen appears. 


re 


Live Server O15 
(9) Launch a development local Server with live 
Ritwick Dey 


@ You can click Search Extensions in 7 
Marketplace and type a search term to ssted dele 
search by name. 


76 aT 


However, the Python extension often Eee CTS == oe Saas 
appears toward the top of the Popular list, sa ia oo * is 
which is sorted by number of downloads, 
so you may not need to search. 


Search Exte 


Python. *2022-10.33es161279 


> INSTALLED o 
ee am Microsoft | @ 44,102,495 | dete dete Hr (442) 
F 2 4kIM es IntelliSense (Pylance), Linting, Debugging (multi-threaded, remote), J... 
int (Pylance), Linting, Debugging (m. e 
© Click Python. rs ey 
es —e debugging, “Or Feature Contributions Changelog Extension Pack 


The information screen for the Python 
extension appears. 


Categories 


Jupyter notebook support, interactive pr 
Microsoft 


Python extension for Visual Studio 
Code 


ESLint > 
Integrates ESLint JavaScript into VS 


{A Visual Studio Code extension with rich support for the Python 
language (for all actively supported versions of the language: > =3.6), 
including features such as intelliSense (Pylance), linting, debugging, 


code navigation, code formatting, refactoring, variable explorer, test 


@ You can read detailed information about 
the extension. 


Prettier - Code formatter 159M #35 


explorer, and more! 
Code formatter using prettier 
e 


NOTE: Support on the web -- eg. github.dev --is limited. 


Cli " Tse tl Mea ne Resources 
1c Ss a . Launch a development local os Installed extensions Marketplace 
Ritwick Dey Repository 

; é Visual Studio IntelliCode The Python extension will automatically install the Pylance and License 
Visual Studio Code downloads the Python Arassisted development lupe extersions to give youthe best experience when woking wih 4 


Python files and Jupyter notebooks. However, Pylance is an op! 
dependency, meaning the Python extension will remain fully 
functional if it fails to be installed. You can also uninstall it at the 


Released 1/19/2016, 
15:03:11 
pn 202 


extension and installs it. 
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@ You can click Disable if you need to 
disable the extension temporarily 
without uninstalling it. 


@ You can click Uninstall if you decide 
you want to uninstall the extension. 


6 Click Installed. 


The Installed list expands. 


@ You can see all the extensions you 
have installed. 


@ You can click Settings (3 
configure settings for an 
extension. 


@ Click Close (x). 


The pane showing information 
about the Python extension 
closes. 


@ Click Extensions (HH). 
The Extensions pane closes. 


) to 


What other extensions can I use for Python in Visual Studio Code? 
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>) File Edit Selection View Go Run Terminal Help 
EXTENSIONS. yo 
Search Extensions in Marketplace 


> INSTALLED. 


ce), Linting, Debug} 


C/C++ uM *35 
C/C++ Intellisense, debugging, and code br... 
finstai | 


Microsoft 


Jupyter 
Jupyter notebook support, interact 
Microsoft 
ESLint 3M &4 
Integrates ESLint JavaScript into VS Code. 
Dirk Baeumer 
Pylance 

A performant, feature-rich language server 
Microsoft 


Prettier - Code formatter D1S9M 3S 
Code formatter using prettier 
Prettier finstat | 
Live Server D1SEM Ks 
Launch a development local Server with ae 
Ritwick Dey {instal | 
Visual Studio IntelliCode Dim wes 
At-assisted development 
Microsoft f install J 
cH D1BIM #35 
> RECOMMENDED ° 


Python 3.10.0 64-bit @0A0 


>] File Edit Selection View Go Run Terminal Help 


EXTENSIONS 
Search Extensions in “9 


~\ INSTALLED 


Python 
al Intellisense mi Linting, Debugging Fs 
Microsoft 


Pylance 
A performant, feature-rich language “e<Q@ f. 


Microsoft 


° Jupyter Notebook Renderers 
‘9 Renderers for Jupyter Notebooks (with plotl 
© Microsoft 


v POPULAR 30769 
sy 


Python 
aa Intellisense (Pylance), Linting, Debugging (m.. 
Microsoft & 


C/C++ Uu3M &35 

C/C++ Intellisense, debugging, and code br... 

Microsoft instal 
st 


: Jupyter 
mors’ Jupyter notebook support. interactive aR 
Microsoft 


ESLint 2 M & 4: 
Integrates ESLint JavaScript into VS Code. 
Dirk Baeumer 


o 

@ 

2 Pylance 
Ba ® 


A performant, feature-rich languag 
Microsoft 


Prettier - Code formatter 


> RECOMMENDED o 


Extension: Python - Visual Studio Code 


Extension: Python X (HD) 


@ 


Details Feature Contributions 


Python se2i.ieissesies 
KK x (442) 


Microsoft | & 44,102,495 


IntelliSense (Pylance), Linting, Debugging (multi-threaded, remote), J... 
cc) 
This extension jflenabled globally. 


gelog Extension Pack Runtime Status 


Categories 


Python extension for Visual Studio 
Code 


Programming 
Languages 
Debuggers | | Linters 
A Visual Studio Code extension with rich support for the Python 
language (for all actively supported versions of the language: >=3.6), 
including features such as intelliSense (Pylance),linting, debugging, 
code navigation, code formatting, refactoring, variable explorer, test 


Formatters | | Other 
Data Science 


Machine Learning 


explorer, and more! Notebooks 
NOTE: Support on the web -- e.g. github.dev -- is limited. Resbiirees 
Installed extensions Marketplace 
Repository 
The Python extension will automatically install the Pylance and License 
More Info 


Jupyter extensions to give you the best experience when workingasith 
Python files and Jupyter notebooks. However, Pylance is an op! 
dependency, meaning the Python extension will remain fully 


Released 1/19/2016, 


Extension: Python - Visual Studio Code - oa x 


Extension: Python &- (Ho) 5 


& 


<Q ils Feature Contributions Changelog _ Extension Packg 


Python \2e2t.ae.ssesisi279 


Microsoft | > 44,102,681 | oo 3 (442) 


IntelliSense (Pylance), Linting, Debugging (multi-threaded, remote), J... 


ESS EIS « 


This extension is enabled globally. 


Python extension for Visual Studio 
Code 


Categories 


Programming 
Languages 

A Visual Studio Code extension with rich support for the Python 
language (for all actively supported versions of the language: >=3.6), 
including features such as Intellisense (Pylance), linting, debugging, 


Linters | | Debuggers 
Formatters 


+ Data Scier 
code navigation, code formatting, refactoring, variable explorer, test exiocaiad 


explorer, and more! Machine Learning 


Notebooks 
NOTE: Support on the web -- e.g. github.dev ~ is limited. 
: Resources 
Installed extensions 
Marketplace 
The Python extension will automatically install the Pylance and Repository 


Jupyter extensions to give you the best experience when working with License 
Python files and Jupyter notebooks. However, Pylance is an op’ 
dependency, meaning the Python extension will remain fully 
functional if it fails to be installed. You can also uninstall it at the 


More Info 


Released 1/19/2016, 
RO 


A wide range of Visual Studio Code extensions is available for working with Python; you can get a list by 
entering python in the Search Extensions in Marketplace box in the Extensions pane in Visual Studio Code. 


In particular, you may want to try the Python Indent extension, which automatically controls indentation 
on new lines of code, and the Python Snippets extension, which can save you typing by providing built-in 
code snippets. Look also at the Kite AutoComplete AI Code extension, which provides automatic completion 
for both Python and other major programming languages. 
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Configure Visual Studio Code for 
Working with Python 


Ve Studio Code is highly customizable, so you should spend a few minutes configuring the 
code editor suitably for your work in Python. This section shows you how to access Visual Studio 
Code’s configuration preferences and explains the preferences you are most likely to benefit from 
setting. These preferences include the “Files: Auto Save” setting, which controls whether Visual 
Studio Code automatically saves unsaved changes as you work; the font size and font family in which 
Visual Studio Code displays your code; and whether Visual Studio Code automatically inserts a closing 
bracket to match each opening bracket you type. 


® Launch Visual Studio Code. 


For example, on Windows, click Start (G4) to 
open the Start menu, and then click Visual 
Studio Code (fH). 


@) Click File. 


The File menu opens. - cece 
© Click or highlight Preferences. 

The Preferences submenu opens. 
@ Click Settings. 


Note: On Windows and Linux, you can press @)+@ 
to display the Settings screen. On macOS, press 
€3+@. Alternatively, click Manage (f¥) in the 
lower-left corner, and then click Settings on the 
menu that opens. 


Settings - Visual Studio Code ST ee 


The Settings screen appears. 


@ The Commonly Used settings category appears at 
first. 


Note: If the Commonly Used category does not 
appear, click Commonly Used. 


© Click Files: Auto Save (~”), and then click the Auto 
Save option you want. See the first tip for advice. 


@ Click Editor: Font Size and type the font size 
you want to use in the editor. 


Editor: Render Whitespace 
Controls how the editor should render whitespace characters. 


@ You can click Editor: Font Family and type the font family you want to use in the editor. 
@ Click Text Editor. 
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CHAPTER 


Getting Ready to Work with Python 1 


The Text Editor settings category appears. 4 file Edit Selection View Go Fun Terminal Help Sainaia vain susie coae aa s 


@ Click Auto Closing Brackets (~”), and then click 
always, languageDefined, beforeWhitespace, 


Tum on Settings Sync 


Commonly Used Text Editor 
> Text Editor 
or never, as needed. Sear ieee) ut 
> Window Controls the number of lines in the editor that can be read out by @ screen reader at once. When we detect a screen 
> eee 10) reader we automatically set the default to be 500. Warning: this has a performance implication for numbers larger than the 
Note: Auto Closing Brackets controls whether Visual een 7 


> Extensions 


Studio Code automatically enters a closing bracket 
when you type an opening bracket. Auto Closing 
Delete controls whether Visual Studio Code 
automatically deletes adjacent closing quotes or 
brackets during deletion. 


@ Click Auto Closing Delete (x), and then click 
always, auto, or never, as needed. edn atest casein ipeoecueaa gute bead 


® Click Features. J file Edit Selection view, Run Terminal Help Settings - Visual Studio Code - o Ef 


The Features settings category appears. aaa 


Commonly Used 


@) Click Auto Reveal (x), and then click true, ——— 
false, or focusNoScroll, as needed. > ween lie 


Accessibility Support 
Controls whether the editor should run in a mode where it is optimized for screen readers. Setting to on will disable word 
wrapping, 


auto 
| ‘Auto Closing Brackets 


Controls whether the editor should automaticaly close bracketgaiiagthe user adds an opening bracket. 
always 


Auto Closing Delete 


Controls whether the editor should remove adjacent closing ay brackets when deleting, 
auto v 


Auto Closing Overtype 


— aed 
° Explorer Controls whether the explorer should automatically reveal and splagbSles when opening them. 
@® Select Confirm Delete (@) to make the explorer er = << 
fi file deleti = 
confirm your file deletions. “ cues 
enon V/) Controls whether the explorer should render folders ina compact form. In such a form, single child folders will be 
enwinal compressed in a combined tree element. Useful for Java package structures, for example, 


@®) Select Confirm Drag And Drop (@) to make the = 
ex p lo rer con fi rm yo ur fi le d rag -an d -d ro p actio ns. Output 12 Controls whether the explorer should ask for confirmation when deleting a file via the trash. 


Timeline 13 Drag And Drop 
Wh fi i h fi ] tti li k Nieto {/| Controls whether the explorer should ask for confirmation to move files and folders via drag and drop. 
@) When you finish configuring settings, clic — 


Close (x sect i tcl stg 


The path separation character used when copying relative fle paths. 


auto 


The Settings tab closes. 


Decorations: Badges 


What are the Files: Auto Save options? How do I update Visual Studio Code? 
Click off to disable automatic saving. Click onFocusChange to By default, Visual Studio Code 

save changes when you move the focus from the file that contains | automatically checks for updates and 
changes. Click onWindowChange to save changes when you notifies you when one is available. If 


activate another app. Click afterDelay to have Visual Studio Code Visual Studio Code displays the Restart 
automatically save changes after a delay. The default delay is 1000 | Visual Studio Code to Apply the Latest 
microseconds — 1 second. To change the delay, click Text Editor Update dialog box, click Update Now to 
and change the value in the File: Auto Save Delay box. start the update. 
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CHAPTER 2 


Writing and 
Running Your 
First Python Code 


In this chapter, you start writing code in Python using the Visual Studio 
Code editor and the terminal window. You learn about Python’s main () 
function and create a simple function. You also learn how to run code 
either in Visual Studio Code or in a terminal window, add comments to 
your code, and import and use Python modules and objects. 


J File Edit Selection View Go Run --- 


LIpy * 


Ln9,Col52 Spaces:4 UTF-8 CRLF Python 3.10.064-bit & O 


r= ENG fs 11:40 AM 
A 
Be ys ‘sl @ anayzoz2 
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Understanding the main() Function 


ou can create a Python script that simply uses commands and does not define any functions; you 

do this extensively later in this book. But many Python scripts include a function called main () 
that contains the main set of actions the script performs. In this section, you learn the purpose of 
the main() function and when and how to create one. 


You also learn about the two ways to run code using the Python interpreter. How you run a script 
affects how Python sets the built-in | name __ parameter, which you can use to control whether the 
main() function runs. 


What Is the main() Function? 


As its name suggests, the main() function typically forms the core part of a Python script. You would 
normally use the main() function in conjunction with an if statement that checks the value of the 
__name__ parameter. Doing so enables your script to determine whether it was launched from the command 
line or whether it was imported into the interpreter or into another script or module. 


Here is pseudocode showing a main() function and its if statement, with italics indicating a placeholder: 


def main(): 
statements 


alae name 
main () 


Here is how this works: 
© def. This keyword starts the definition of the function. 


¢ main() :. This is the name of the function, followed by a colon to end the line. This line is called the 
function header. 


statements. This is where you place statements that specify the actions the main () function is to take. 
The statements are indented by four spaces to indicate that they belong to the function’s block of code. 


if. This keyword begins the condition, which compares the value of the name __ parameter to the 
string" main". Two equal signs, ==, denote equality. The double quotes, ", mark the beginning and 
end of a literal string of text. The colon ends the line. 


main(). This statement tells Python to execute the main() function if the condition evaluates to True. 
This statement is indented by four spaces to show it belongs to the if statement’s block of code. 
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When Should You Create a main() Function? 


Create a main() function in any script that you want to have execute in a different way when it is run from 
the command line than when it has been imported into the interactive interpreter or into another script or 
module. 


Understanding the Two Ways to Run Python Code 


You can run a Python script either by launching it from the command line or by importing it into the 
interactive interpreter or another Python file. 


Launch a Script via the Command Line 


The first way to launch a script is by using the command line. You start by opening a terminal window, such 
as a Command Prompt window on Windows or a window in the Terminal app on macOS or Linux. You then 
navigate to the appropriate folder, type the Python app’s name and the script’s name, and press (§. 


For example, to run the script called my script .py from the current folder, you might use this command 
on Windows: 


python myscript.py 
Or you could use this command on macOS or Linux: 
python3 my_script.py 


When you launch a script from the command line, Python sets the script’s name ___ parameter to 
__main_. 


Import a Script into the Interactive Interpreter or into Another Script or Module 


To import a script, you use the import keyword followed by the script’s name without its extension. For 
example, if the script’s name is acme _calcs.py, you can import it using the following statement: 


import acme_calcs 


When you import a script into the interactive interpreter, into another script, or into another module, 
Python sets the script’s _ name __ parameter to the script’s name without the extension. Continuing the 
previous example of importing, Python sets the name __ parameter to acme _calcs. 
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Create and Save a New Script in Visual Studio Code 


T this section, you run the Visual Studio Code app, create a new script, and specify that you want to 
use the Python language for the script. You then save the script under a name of your choice in a 
suitable location, creating a new folder if necessary. Saving the script file gets you ready for creating 
code in it, which you do in the following section, “Write and Run Code in Visual Studio Code.” 


@ Open Visual Studio Code if it is not already SS | ha 
. Untitied-1. O- 
running. elect a Language to get started. Start typing to dismiss, or 
don't show this again. 


For example, on Windows, click Start (8), 
and then click Visual Studio Code (§). 
On macOS, click Launchpad (:::), and 
then click Visual Studio Code (M). 


Note: If Visual Studio Code is already running 
or does not start a new script by default, start 


a new script manually by pressing @iTe)+@ 
on Windows or Linux or (3+ on the Mac. 


>} File Edit Selection View Go Run --- Untitied-1 - Visual Studio. JT 08 — o Be 


Untitied-1 | select Language Mode ae 


EI Auto Detect |, or 
dot Batch (bat) languages (identifier) 

BibTeX. (bibtex) 

Binary (code-text-binary) 


ccw 

© Ce (csharp) 

@ C++ (cpp) 

© Clojure (cojure) 
 CoffeeScript (coffeescript) 
& Compose (dockercompose) 
# CSS (css) 

@ CUDA C++ (cuda-cpp) 


x File Edit Selection View Go Run --- Untitied-1 - Visual Studio. JT 08 — a x 
Tiles 


The Select a Language to Get Started ee 
prompt appears. etait, 4 ) 
@ Click Select a language to get started. reves eet) 
© CoffeeScript (coffeescript) 
@ The Select Language Mode pop-up menu Se 
opens. 5 View Go Run = Untitled-1 - Visual Studio. DIT 0 - GQ xX 
New File Ctrl+N by ih 


© Type p. 


The P section of the pop-up menu 
appears. 


© Click Python (python). 


@ Visual Studio Code sets the language 
to Python. 


@ Click File. 
The File menu opens. 
@ Click Save. 


Note: On Windows and Linux, you can press 


(2+ BG to give the Save command. 
On macOS, press (3+@. 


New File... Ctrl+Alt+Windows+N 
New Window Ctri+Shift+N 


Open File... Ctri+O 
Open Folder... Ctrl+K Ctrl+0 


Open Workspace from File... 


Open Recent > 


Add Folder to Workspace.., 
Save Workspace As... 


Duplicate Workspace 


Save As... Ctrl+Shift+S 


v Auto Save 
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The Save As dialog box opens. 


@ Navigate to the folder in which 
you want to store your script. 


6 If you need to create a new 
folder for your Python code, 
click New folder. If not, go to 
step 11. 


@ The app creates a new folder. 


@© Type the name for the new folder, 
and then press Guow. 


(10) Double-click the new folder. 


The folder opens. 
11) Type the filename for the script. 


® Verify that Python is selected in the 
Save As Type drop-down list. 


® Click Save. 
The Save As dialog closes. 
Visual Studio Code saves the script. 


You can now enter the code for the 
script. See the next section, “Write 
and Run Code in Visual Studio 

Code,” for an introductory example. 


2 Save As x 
<€ > » %  & > ThisPC > Documents > - CG 2 Search Documents 
Organize ¥ New a 8 ) =v e 
A 
Name Date modified Type $ 
> We Quick access 
‘BD Custom Office Templates 3/7/2020 10:47PM File folder 
¥ & Dropbox (&y My Data Sources 12/19/2021 10:21... File folder 
> GE TWPython 5 Older Documents 4/9/20204:03PM File folder 
> @ Onbine-Pesond ‘1D Reference 3/9/2020 10:09AM File folder 
‘DD Spreadsheets 10/28/2021 9:41 AM File folder 
¥ Gi ThisPc 
‘DD Templates 8/6/2021 10:10PM File folder 
> GR Desktop 


7 Documents 
C [Pythor| <a) 4/13/2022 11:53 AM _ File folder 
> & Downloads 
File name: | Untitled-1 10 5 


Saveastype: Python v 
A Hide Folders Cancel 
QJ Save As x 
< > »~ 4% GB» ThisPC > Documents > Python » CG 2 Search Python 
Organize New folder = e 
a 
Name Date modified Type 
> We Quick access 
No items match your search. 
v AF Dropbox 
> 6 TW_Python 
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f) Mac Files 10/28/2019 10:34... Shortcut 


> @ OneDrive - Personal 
¥ Gi ThisPc 

> Gil Desktop 

> J Documents 


> & Downloads 


File name: seit r ) v 
Save as type: Python v 


A Hide Folders Cancel 


Should I use the Auto Save feature in Visual Studio Code? 


You decide. You can toggle Auto Save on or off by clicking File to open the File menu and then clicking 
Auto Save to display or remove the check mark next to it. To configure Auto Save, click File, click or 


highlight Preferences, and then click Settings to display the Settings screen. In the left pane, click 
Commonly Used to display the Commonly Used list. Click Files: Auto Save (~~) and then click afterDelay 
to save after a short delay, onFocusChange to save after you move the focus in the code window, or 


onWindowChange to save after you activate another window. 


0005377493.INDD 33 Trim size: 7.375 in x 9.25 in 


33 


July 1, 2022 9:04 PM 


Write and Run Code in Visual Studio Code 


fter creating a new script file in Visual Studio Code, as explained in the previous section, “Create 

and Save a New Script in Visual Studio Code,” you can write code in the script and then run it. In 
this section, you create a short script that demonstrates how the script’s _ name ___ property varies 
depending on how you run the script. The script uses the print () function to display output and 
includes an if... else statement, a decision-making tool you will meet in detail in Chapter 6, 
“Making Decisions with if Statements.” 


Write Code in Visual Studio Code File Edit Selection View Go Run 1 Script1py - Visual Studio. FO 08 — 
. . . ® Script_ipy x 
(1) Open Visual Studio Code, and then open the new script tee ee 
file you created and saved in the previous section. = i 
( ues: object, sep: str | None end 
On line 1, type the following statement, which uses cia, seeereainney aN 
the def keyword to create a function named main(). = ——— 
print(value, .., sep="', end="\n’, file=sys.stdout, 
flush=False) 
Press Enter } Prints the values to a stream, or to sys.stdout by 
: default. Optional keyword arguments: 
def main () : A file: a file-like object (stream); defaults to the current 


a2) sys.stdout. 


Vv 


@ Visual Studio Code automatically indents the next line, 
making it part of the code block for the main () 
function. 


© Type the following partial statement: 


File Edit Selection View Go Run --- Script_t.py - Visual Studio... FI] IT) 08 — o x 
i ® Script_ipy x SSeoutliyacns 
pesne ( > ® Script_t.py > @ main 
‘ ‘ , . 1 “ae ‘main (| 
@ Visual Studio Code automatically enters the closing print 
parenthesis, ), for you to the right of the insertion 
point. 
; 4a ” x) File Edit Selection View Go Run --- Script_i.py-Visual Studio. DOOM 08 - OF x 
@A ScreenTip containing help for the print () function exanien STS 


C: > Users > guy > Documents > Python > @ Script_t.py > ... 


vere fa ee ee | 
© Type". 2 i”. 

Visual Studio Code enters the closing quotes for you, 
again to the right of the insertion point. 


@ Press G to move the insertion point past the 


@ Visual Studio Code highlights the parentheses to closing quotes, and then press Gute. The 
indicate that they are a matching pair. complete line of code looks like this: 
5 Inside the quotes, type the following string of text, print ("The main function is 
carrying the closing quotes along to the right: running.") 


The main function is running. 
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Visual Studio Code retains the indent >) File Edit Selection View Go Run ~~ Script 1.py- Visual Studio...) OP 08 
on the next line. © script.tpy 1 x 
C: > Users > guy > Documents > Python > @ Script_1.py > @ main 
@ Type the following partial statement, 1 def main(): 
. . ‘ 2 print("The main function is running.") 
which uses the print () function 5 = 2 eS ak 
to display information about the = 
. f€] ___annotations__ 
___name___ parameter, moving the (el _qualname__ 


closing parenthesis along to the right. 


print ("The _ name parameter 
ae de na 


Note: When you type the closing quotes, 
", Visual Studio Code moves the insertion 
point to the right of the " character that 
your typing has been carrying along. You 
can also press () to move the insertion 
point past the " character. 


@ When you type __na, Python displays [#0 Fie cxit selection View Go Run 


an AutoComplete list of matching ® Script_t.py x 
I C: > Users > guy > Documents > Python > @ Script_1.py >... 
items. 1 = def main(): 
7 2 print("The main function is running.") 
8 ) Click __name_. 3 print("The __name__ parameter is: " + __name__ 
4 


Visual Studio Code enters the __ 
name___ item, so the statement looks 
like this: 


print ("The _ name parameter 
is: "+ __name_) 


© Type ) to move the insertion point 
past the closing parenthesis, and then 


press Gite. 
© Press to delete the indent, 


ending the main() function’s block, 
and then press co again. 


TIP 


How else can I navigate the AutoComplete list? 
Instead of clicking the item you want to insert in your code, you can press () or (J to move the highlight 


to the item and then press or (2009 to enter it. You can also “type down” to highlight the name — 
simply continue typing the remaining characters of the name until Visual Studio Code highlights the name. 


continued 
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Write and Run Code in Visual Studio Code (continued) 


N ormally, theif | name == "_ main" Statement does not have an else statement, 
as the if statement is all that is needed to control whether the main() function runs. In 
this example, however, you add an else statement to demonstrate how the value of _ name __ 
changes when you run the script by importing it. The else statement runs when name ___is not 
__main__; it displays a message including the value of name. 


If you have turned off Visual Studio Code’s Auto Save feature, save your work manually whenever you 
have made changes you would rather not have to make again. 


Visual Studio Code creates a blank line. 


@) Type the following if statement, which 
compares the value of _ name ___ to the 
string main, and then press G3: 


Lt name == "main ": 


@ Python indents the next line, making it part 
of the if block. 


@® Type the following statement, which runs the 
main() function, and then press GG): 


main () 


& Press to delete the indent, and 
then type the else keyword and a colon. 


Press Gap. 


else: 


Visual Studio Code indents the next line, 
making it part of the else block. 


©) Type the following print () statement, and 
then press GG3: 


print ("The main function is not 
running.") 


® Type the following statement, which is the 
same as that in line 3: 


print ("The _ name parameter is: 
"+ —name_) 
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J File Edit Selection View Go Run = Script_.py- Visual Studio. DIM 08 -— oO x 
® Script_i.py x Bre 
C: > Users > guy > Documents > Python > @ Script_t.py > 
1 def main(): =i 
2 print("The main function is running.") 


print("The __name__ parameter is: " + __name_) 


3 
4 
5 if _name_ == "_main_" =~ 11) _ 
6 
7 


sr 


® Script_ipy x Bw 
C: > Users > guy > Documents > Python > @ Script_1.py >. 
1 def main(): = 
2 print("The main function is running.") 
3 print("The __name_ parameter is: " + __name_) 
4 
5 if _name_ == "_main_": 
6 main() 


13 ee 14) 7 


print("The main function is not running." 
9 print("The __name_ parameter is: " + ee 15) 
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Run Your Script in Visual Fle Edit selection View Go fun =~ Sciptiey-VewlSudio. OOO 0 - oO x 
Studio Code 


Click Run Python File in 


® Script_ipy X oe EY ats 


C: > Users > guy > Documents > Python > # Script_1.py > ... 
1 def main(): Soca. 


D 2 print("The main function is running.") 
Terminal (D). 2 print("The __name__ parameter is: " + __name_) 
: : 4 

The Terminal pane appears in the 5 if _mame_ == "“_main_": 7 
lower part of the Visual Studio S 
Code window. 8 print("The main function is not running.") 

9 print(("The __name__ parameter is: " + __name_)| 

@ The script’s path and name 
PROBLEMS OUTPUT  DEBUGCONSOLE TERMINAL >] Python +e a x 


appear here. 


Windows PowerShell 
Copyright (C) Microsoft Corporation. All rights reserved. 


@ The script’s output appears, 
indicating that the main () 
function is running and that the 
value of the name ___ parameter 
is omain_. 


@ Click Kill Terminal (iii). 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows 


PS C:\Users\guy> & "C:/Program Files/Python310/python.exe” €:/isers/gu/Ooeunents/Python/serit <A) 
“py 


The main function is running. 
The __name__ parameter is: oH) 
PS C:\Users\guy> 


@oAo Ln 9,Col52 Spaces:4 UTF-8 CRLF Python 3.10.064-bit & O 


J File Edit Selection View Go Run -- Script_1.py - Visual Studio... DOM 08 -— oa x 
Visual Studio Code kills the ® scriptipy x Se ye 
Terminal C: > Users > guy > Documents > Python > # Script_1.py >... 
: 1 def main(): Enact 
. 7 2 print("The main function is running.") 
Visual Studio Code closes the 3 print("The __name__ parameter is: " + __name_) 
Terminal pane. : . 
5 if _name_ == "_main_" 
6 main() 
7 else ] 
8 print("The main function is not running.") 
9 print("The __name__ parameter is: " + __name_)) 


Ln9,Col52 Spaces:4 UTF-8 CRLF Pythor 


How can I save time when creating repetitive code in Visual Studio Code? 

You can use the Copy and Paste commands. For example, instead of typing a line of code again, select a 
previous instance, and then give a Copy command, such as clicking Edit and then Copy; click in line 8, and 
then give a Paste command, such as clicking Edit and then Paste. If you prefer, you can use the standard 


keyboard shortcuts: Press Gite) +©@ for Copy, GETZI+@ for Paste, or GEND+ EY for Cut. On the Mac, 
press €3+@, 6+G, and +63, respectively. 


0005377493.INDD 37 Trim size: 7.375 in x 9.25 in July 1, 2022 9:04 PM 


Execute Python Commands in a Terminal Window 


he Python interactive interpreter enables you to execute commands in a terminal window. You 

open a standard terminal window, such as a Command Prompt window on Windows or a Terminal 
app window on macOS or Linux; and then launch the interactive interpreter using the python 
command on Windows or the python3 command on macOS or Linux. You can then type Python 
commands and get an immediate response. 


Working in the interactive interpreter is great for learning, and you will use this approach extensively 
in this book. This section provides an introduction to the interactive interpreter. 


Execute Python Commands in a Terminal Window 


@ Open a terminal window. ita 


For example, on Windows, click Start (GA), type com, and 
then click Command Prompt (i). 


@ Type python and press GED. A ee ala your name: ey 
Note: On macOS and Linux, type python3 and press Guu. 
The interactive interpreter launches. 
@ The Python prompt, >>>, appears. 


@ Type the following statement, which creates a variable 
named u and assigns to it the result of the input () 
function prompting you to type your name. Press @ioo. 


u = input ("Type your name: ") 
Python displays the prompt: 
Type your name: 
4 Type whatever you like, and then press (ac. 
Python accepts your input. 
e Type the following statement, which uses the print () 


>> u= input ¢" ape your name: ") 
pe your name: 

>> print("You oe Mn + o<@ 
ou are Ann 


fH Command Prompt 


AUSer Say en yee 
ython 3.10.0 (t oO ae cc 0: peeereee Oct 4 203 
[Msc v.1929 64 64)] o n32 
pe "help", See ee "credits" nee "licensé 
finformation. 


P>> quit() 
Cc: \Users\guy> 


function to display a short message including what you 
typed. Press G@NG3. 


print ("You are " + u) 


Python displays the message, such as this: 


You are Ann 
. The terminal window’s standard prompt 


@ Iype the following statement, which gives the quit () appears again. 


command, and then press Giloo. 
P Note: Use the quit () command when you want 


qaie to quit Python. For concision, terminal window 
The Python interpreter quits. tasks from here on do not show this command. 


38 


0005377493.INDD 38 Trim size: 7.375 in x 9.25 in 


July 1, 2022 9:04 PM 


CHAPTER 


Run a Python Script ina Terminal Window 


fter creating a Python script, you can execute it by running it in a terminal window. In this section, 
you open a terminal window and run the script you created earlier in this chapter, which shows you 
whether the main() function is running and what the value of the name ___ parameter is. 


You then launch Python and import the script. By doing so, you can see the different way in which 
Python handles the main() function for a script you import. 


Run a Python Script in a Terminal Window 


@ Open a terminal window. _— EE 

guy@Mac-Pro-3 cd Dropbox/TW.Python/ Code a I 

For example, on macOS, click Launchpad (#3), and then click A. Lleol G0 Liane rnin 
e The __name__ parameter is: __mi 

Terminal (@). 


@ Change the directory to the one in which you saved the 
script. The following macOS example uses the cd command 
to change to the ~/Dropbox/TYV_Python/Code directory, 
starting from the user's home directory, which is represented 
by ~. 


cd Dropbox/TYV_Python/Code 


3 ) On Windows, type python; on macOS or Linux, type python3. 


4) On the same line, type a space, and then type the name of 
the script. For example, on macOS, the following command 
runs the script Script _1.py: 


eee (i Code — -zsh — 57%27 
guy@Mac-Pro-3 ~ % cd Dropbox/TYV_Python/Code ig 
guy@Mac-Pro-3 Code % python3 Script_1l.py ] 
The main function is running. 
The __name__ parameter is: mai, 
guy@Mac-Pro-3 Code % python: 

Python 3.10.0 (v3.10.0:b494f593. ict 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "license" for more 
information. 

>> import Script_1 ) 


The main function is not running. 
The __name__ parameter is: Script_1l 


guy@Mac-Pro-3 Code % | | 


python3 Script_1.py 


@ The script’s output appears, indicating that the main () 
function is running. 


< 
a 


5 ) Type python on Windows, or python3 on macOS or Linux, 
and then press (cy. For example, on mac0S, type this: 


python3 
Python launches. 
@ The Python prompt appears. 


@ Type the following statement, which uses the import 
statement to import the script as a module: @ Type the quit () command, and then 


press Gig. 


quit () 


import Script_1 


@ The script’s output appears, indicating that the main () 
function is not running and giving the value of the name __ Python quits. 
parameter as Script_1. 
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Understanding Comments in Python 


& most programming languages, Python enables you to add comments to your code. A comment 
is text that appears in a script but that is marked as not to be executed. You can add comments 

to your code at any point. For example, as you develop a script, you might use comments to describe 
the tasks the code needs to perform and possible approaches for them. After finishing the script’s 
commands, you might rework the comments so that they explain what the script does. Such comments 
will help others understand and maintain the code. 


Formally, Python supports only single-line comments, but you can also use multiline strings to create 
informal multiline comments. 


Create Formal Comments Using the # Character 


Python uses the # character to mark the start of a single-line comment. You can place the # character at 
the start of the line to make the entire line into a comment, as in the following example: 


# display the value of y 
print (y) 


Alternatively, you can place the # character after some code, as in the following example. This method 
works better for short comments and for comments you intend to remove once you get the code working. 


t = "Placeholder 1" # replace this placeholder text 


You cannot use the continuation character, \, to continue a single-line comment to the next line. Instead, 
type # at the beginning of the next line if you need to continue the comment, as in the following example: 


# prompt the user for the company name 
# compare the company name to an approved list 


Using Multiline Strings to Create Informal Comments 


Another way to create a multiline comment in a script is to create a multiline string but not assign it to a 
variable. To create a multiline string, you place three double quotes at the beginning and at the end, or 
three single quotes at the beginning and at the end. The following example uses three double quotes: 


Wd 

Run an external check with the chem_verify() method 
to confirm the formula is correct. 

Log the formula in the standard file. 


Wot 


This method of creating informal comments works but has no real advantage over using the # character on 
each line. You should know about this method not because you should use it in your own code but because 
you may encounter it in other people’s code. 
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Using Comments to Prevent Code from Executing 

Apart from adding textual commentary to your code, comments have a secondary use: You can use the 

# character to prevent a specific line of code from executing. This is called commenting out the code — 
turning a statement into a comment prevents the code from running without you having to remove it from 
the script, but you can restore the code by removing the comment character. 


For example, the # character comments out the first of the following statements: 


# uU = input ("Type your name: ") 
u = "Bob" # default name for testing 
joneuliate, (UaKol ewes: WY Sp bl se By) 


Enter Comments in a Terminal Window 


You can enter comments when working interactively in a terminal window. Doing so is sometimes useful, 
such as when you are working in multiple terminal windows and want to make sure you do not lose your 
train of thought. Generally, though, comments are more widely useful when you are creating a script. 


i) File Edit Selection View Go Run -- Untitled-1 - Visual Studio... ID GJ OB 08 


Enter Comments in a Code Editor 
or an IDE ees 


When you are working in a code editor or eux 
an IDE, you can create a comment Copy Ctrl 
manually by typing the # character before = pis 
the comment text. But most code editors eee i 
and IDEs also provide commands for 

commenting out text and uncommenting 


it again. 

Toggle Line Comment Ctri+/ 
For example, in Visual Studio Code, you 
can toggle commenting on or off for the ee = 
current line or selected lines by pressing 
(@575)+ GY on Windows or Linux or 
€3+@9 on the Mac. From the menu bar, 
you can click Edit and then click Toggle 
Line Comment. 


Find in Files Ctrl+Shift+F 
Replace in Files Ctrl+Shift+H 


Visual Studio Code’s Edit menu also offers the Toggle Block Comment, which places three double quotes 
before and after the selected text, making it into an informal comment. You can give this command from 


the keyboard by pressing (2a) + Gin9+E9 on Windows or Linux or @ie9+ G+ EN on the Mac. 
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Add Comments to Your Code 


dding comments to your code can help you develop functional code more quickly and can help 

others understand, maintain, and extend your code. While writing code, add comments freely 
describing the code’s tasks and your current approach. Revise the comments as you progress and 
change your code. Once the code is working, clean up the comments, removing any development- 
related comments and adding any further explanation that is needed or might be helpful. 


You can also use the comment character, #, to comment out lines of code to prevent them from 
running without removing them from the script. 


Add Comments to Your Code 


@ Open Visual Studio Code, create a new script, aie = 1 | hoo @ 
and save it under a name of your choice. ® commentst.py x by O- 
Users > guy > Dropbox > TW/_Python > Code > Comments > @ c ents1.py 
@ Type the following statement, which creates a 2 Oe ee oe rane 
2 u = input("Type your name: ") | 
comment, and then press (neu: 3 


# prompt the user for their name 


@ Visual Studio Code displays the comment text in 
green to make it easy to see in your scripts. 


3 ) Type the following statement, which creates a 
variable named u and assigns to it the result of 
the input () function, prompting the user for 
their name. Press Guay. 


u = input ("Type your name: ") 


Ln3,Col1 Spaces:4 UTF-8 LF Python 3.10.0 64-bit 


comments1.py OO 


© Type the following comment, and then 
press GSD: 


# display the name entered 


® comments1.py x - 


Users > guy > Dropbox > TYV_Python > Code > Comments > @ commentsi1.py > ... 
1 # prompt the user for their name 


2 u = input("Type your name: ") 
3 # display the name entered —@y 


@> vice are"“+u+".") 


5 ) Type the following statement, which uses the 
print () function to display a message that 
includes the contents of u. Press GNC. 


print ("You are " + u + ".") 

@ Click Run Python File in Terminal ([>). 
The Terminal pane opens. 

@ Click in the Terminal pane. 

6 Type a name, and then press Guco. 


@© Python displays the message. 
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PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE + ax 


guy@Mac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Pytho 3] Python guy 
n/Code/Comment 
s/comments1.py 


G) Python guy 
Type your name: Will 
‘ou are Will. <G) 


guy@ac-Pro-3 ~ % ff 


i) Ln5,Col1 Spaces:4 UTF-8 LF Python 3.10.0 64-bit 
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Comment Out a Statement and Sean 
Uncomment It Again ® commentst.py x 
; a - ‘é Users > guy > Dropbox > TYV_' > Code > Comments > & comments!1.py > ... 
Click at the beginning of line 2, and then type 1 # prompt the uMfr for their name 


u = input("Type your name: 2) 


u = "Ivy" 
# display{ the name entered 
print(" are" +u+".") 


# and a space so the line reads like this: 
# U = input ("Type your name: ") 


@ Visual Studio Code displays the line in green, 
because it is now a comment. 


(2 } Click at the end of line 2, and then 


press Gitay. 


Visual Studio Code creates a new line. PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +v ax 
. . guy@fac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Pytho G] Python guy 
© ype the following statement, which creates a Typesour tare! watt BI Pyiienioiy 
i ‘ 3 ‘ou are Will. 
variable named u and assigns the value Ivy to it. guy@ac-Pro-3 ~ % 
u-=" Ivy" 
Ln3,Col10 Spaces:4 UTF-8 LF Python 3.10.0 64-bit 
4 ) Still on the same line, type a comment so the comments py ooo @ 
line reads like this: ® commentsi.py x . 
Users > guy > Dropbs ‘V_Python > Code > Comments > @ comments!1.py > ... 


# promptWhe user for their name 


1 
Ge: = input("Type your name: ") Z ri 


3 #u= "Ivy" # default name for, testing 
4 # display the name entered 

5 

6 


u = "Ivy" # default name for testing 
@ Click Run Python File in Terminal ([>). 


print("You are " + u + ".") 


@ The message appears, showing the default name. 
@ Click in line 2 and press GED +B. 

@ Visual Studio Code uncomments line 2. 
Note: On the Mac, press €3+@B. 
@ Click in line 3 and press @&ntey+@. 


Visual Studio Code comments out line 3. 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +» ax 


guy@ac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Pytho G] Python guy 
n/Code/Comments/comments1.py 
Type your name: Will GB] Python guy 
You are Will. 


guy@Mac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Pytho 
n/Code/Comments/comments1.py 

‘ou are Ivy. 

guy@ac-Pro-3 ~ % [] 


0 Ln3,Col16 Spaces:4 UTF-8 LF Python 3.10.0 64-bit 


Why does Visual Studio Code automatically enter # at the start of a | What happens if I use two # 
new line after a comment? characters at the start of a 
Visual Studio Code automatically enters the # character when you press comment? 


(@3E3 with the insertion point inside a comment, breaking it to the next The first # character tells Python 
line. If this happens when the insertion point is apparently at the end ofa __|_ the rest of the line is a comment, 
comment line, chances are that there is a space to the right of the insertion | so the second # character 

point that is causing Visual Studio Code to continue the comment. becomes part of the comment. 
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Grasp Importing Modules and Objects 


hen you load Python using the python or python3 command, depending on the operating 

system, Python loads its core modules, which provide essential functionality. When you need 
further functionality, you can import one or more additional modules, files containing Python code. 
For example, when you need to work with directories, such as creating or deleting them, you can 
import the os module, which contains methods for interacting with the operating system. 


You can either import an entire module by using an import statement or import an individual object 
from a package by using a from... import statement. 


Understanding What Modules Are and Why Python Uses Them 


In Python, a module is a stand-alone file that contains code. Python breaks down code into modules so as 
to have multiple smaller files rather than one gargantuan file. These smaller files have various advantages, 
such as helping the organization of code by functionality, streamlining the updating of code, and making 
code run better on less-powerful systems by avoiding loading items that are not needed. 


The main disadvantage of having code in separate modules is that your code must load any modules it 
needs. But as you will see, loading the modules is quick and easy. 


Import a Module 


To import a module, use the import keyword and specify the module name. For example, the following 
statement imports Python’s os module, which provides operating system-related commands: 


import os 


Similarly, if you have created a custom module named acme_calculations.py, you can import it by 
using the following command: 


import acme_calculations 
Note that you omit the . py file extension from the custom module’s filename in the import statement. 


When you import a module of your own like this, navigate to the directory that contains the module first, 
and then launch Python from there. Alternatively, you can import the module from a subdirectory of the 
directory from which you launched Python. For example, if the acme_calculations module is stored in 
the final subdirectory, specify the subdirectory like this: 


from final import acme_calculations 
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Access the Contents of an Imported Module 


When you import a module like this, you specify the module’s name to access its contents. For example, the 
os module's contents include the path module, which provides methods for working with file-system path 
names. After importing the os module, you access the path module like this: 


os.path 


Similarly, if you have imported the acme calculations module, and it contains a method named 
ave product, you access it through the module like this: 


acme_calculations.ave_ product () 


Import an Object from a Module 


Instead of importing an entire module, you can import a single object from a module. You might do this if 
that object is the only part of the module you will need and you want to be able to refer directly to the 
object rather than having to refer to it via the module. Counterintuitively, importing only an object does 
not reduce resource usage, as Python imports the whole module into its mapping table; the difference is in 
how you refer to the object. 


To import an object from a module, begin the statement with the from keyword; then supply the module 
name, then the import keyword, and finally the object name. For example, the following statement imports 
the path module from the os module: 


from os import path 


After importing a single object like this, you refer to it by its unqualified name, such as path in this case, 
rather than via its parent module, such as os. path. Here is an example: 


print (path) 


If the object you import contains other objects or methods, you can access those objects or methods by 
using the name of the imported object followed by a period and the name of the item you want to use. 

For example, the path object contains many methods, including os. path.basename (), which returns the 
base name of the specified path. After importing the path object, you can access the basename () method 
via the path object like this: 


path. basename () 


You can also import a nested object on its own. For example, the following statement imports basename () 
from os.path: 


from os.path import basename 


continued 
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Grasp Importing Modules and Objects (continued) 


he standard way of importing a module or an object adds it to Python’s mapping table, but 
Python also enables you to import a module or object under an alias of your choice. Using an 
alias can make your code more compact and easier to read. 


Because you have not imported the module, you cannot refer to the object via the module. So if you 
have imported only the path object from the os module, you cannot use os. path to refer to it; you 
must use the unqualified path instead. 


Import a Module or Object Under an Alias 


When you import a module or an object from a module, you can create an alias for the object. For example, 
the following statement imports the module acme _quants derivatives and assigns the alias aqd: 


import acme_quants derivatives as aqd 


You can then use the alias to refer to the module or object. For example, the following statement uses the 
aqd alias to refer to the ohlc() method in the acme _quants derivatives module, assigning it to the 
variable n: 


aqd.ohlc() 


Similarly, you can use the from syntax to import an object from a module under an alias. The following 
example imports the version method from the platform module under the alias pv: 


from platform import version as os version 


Likewise, you can then use the alias in your code. For example, the following statement uses the print () 
function to display the value of the method aliased as os version: 


print (os version () ) 


This statement returns information such as the following on a Mac: 


Darwin Kernel Version 20.6.0: Mon Aug 30 06:12:21 PDT 2021; 
TAOLONE Cocca ol 7/ AWS) 5 AZT 6~3/RELEASE X86 64 


Using an alias can be useful when you import multiple modules or objects that have the same name or 
names similar enough to be confusing. Using a shorter alias can also tighten and streamline your code. 
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List the Methods and Variables in a Module or Object 


After importing a module or object, you can use Python’s dir() function to list the methods and variables 
it contains. For example, if you have imported acme _quants derivatives and assigned the alias aqd, 
you can list the contents of aqd like this: 


dir (aqd) 
Python returns a list of the contents, such as the following: 


To __ Joi ieatiay 9, 9 xeterelneyl 4, 9 0 iealtks abot. 9 7 8 oevolexe 
Ueenane en! a paCkagemn Spe CHE Ta lexpoGbbeweeklyestots! a fiviemmrnucem 
Chant) limpontdatlyestatsl,. lohic' = statbank” » Jtwonminute charac i] 


The items whose names start and end with two underscores are built-in Python methods. These are called 
dunder methods after the double underscore characters that precede and follow their names. 


The items whose names do not use the double underscores, such as import daily stats and ohlc, are 
the methods and variables in the module or object. 


You access the methods and variables through the alias of the imported object. For example, the following 
statement creates a variable named my two minute chart and assigns to it the result of the two_ 
minute chart () method, which it accesses via the aqd alias: 


my _two_minute_chart = aqd.two_minute_chart () 


Reload a Module 


Normally, you do not need to reload a module, because the Python interpreter does not unload modules. 
This means the only reason to reload a module is if it has changed since you first loaded it. While possible, 
such change in a loaded module is relatively rare. 


To reload a module, first use the import command to import the import1lib package: 
import importlib 


You can then use the reload() method of import1ib to reload the module. For example, the following 
statement reloads the module named cust1: 


importlib.reload(cust1) 
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Import Modules and Use Their Methods 


ji this section, you import two Python modules and use the methods they contain. The modules 
you import are called os and sys, two of Python's utility modules. The os module lets you work 
with the computer's operating system, while the sys module enables you to manipulate the Python 
runtime environment. You also import objects from platform, another utility module. 


To use commands in an imported library, you specify the library’s name followed by the command’s 
name. For example, to use the getcwd() method in the os module, you use os. getcwd(). 


Import Modules and Use Their Methods 


e Open a terminal window and launch Python. 


For example, on Ubuntu, click Show Applications (FRR), 
type term, and then click Terminal (i). 


@ The Python prompt appears. 


(2 } Type the following statement, which uses the import 
command to import the os module. Press GNGD. 


import os 


©} Type the following statement, which uses the get cwd () 
method of the os module to return the current working 
directory. Press G@icw. 


os.getcwd () 
@ Python returns the directory, such as '/Users/guy'. 


Note: See Chapter 4, “Working with Files and Folders,” for more 
information about the os module. 


© ype the following statement, which uses the import 
command with the as keyword to import the sys module 
under the alias rt. Press Gacy. 


import sys as rt 


© Type the following statement, which uses the print () 
function to display the result of returning the version 
property of the object aliases as rt. Press GOD. 


print (rt .version) 


@ Python displays the version information, as in the following 
example, with the headline number at the beginning: 


3.10.0 (v3.10.0:b494£5935c, Oct 4 2021, 
14:59:20) [Clang 12.0.5 (clang-1205.0.22.11)] 
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eco ~~ guy — Python — 57x27 
Last login: Tue Apr 12 11:38:20 on ttys00 
guy@Mac-Pro-3 ~ % python3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59: 341 
[Clang 12.0. 2 (clang- poe 28: 225 aa Oni sca 
Type "help", 
information. 


eco ~ guy — Python — 57x27 

guy@Mac-Pro-3 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59: a 
(clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more 
information. 


3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 
12.0.5 (clang-1205.0.22.11)] 
>> Ef 
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6 ) Type the following statement, which uses the 
from keyword with the import command to 
import the system() method from the platform 


module. Press Guo. 


from platform import system 


@ Type the following statement, which uses the 
print () function to display the result of the 
system() method. Press Gucw. 


print (system () ) 


@ Python displays a term indicating the operating 
system: Windows for Windows, Darwin for 
macOS, or Linux for Linux. 


6 Type the following statement, which uses the 
from keyword with the import command and the 
as keyword to import the processor () method 
from the platform module under the alias cpu. 


Press GG. 


from platform import processor as cpu 


@ Type the following statement, which uses the 
print () function to display the result of the 
cpu() method. Press (nc. 


print (cpu() ) 


@ Python returns the processor type, such as i386 
for an Intel processor or amdke for an AMD 
processor. 


How do I unimport a module or an object? 


eee ~ guy — Python — 57x27 


|guy@Mac-Pro-3 ~ % python3 


Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more 
information. 


'/Users/guy' 

[>>> import sys as rt 

[>>> print(rt.version) 

3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 
12.0.5 (clang-1205.0.22.11)] 

[>>> from platform import systen <Q 

|>>> print(system() 

arwin 


>> § 


eee ~ guy — Python — 57x27 


|guy@Mac-Pro-3 ~ % python3 


Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more 
information. 


'/Users/guy' 

[>>> import sys as rt 

[>>> print(rt.version) 

3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 
12.0.5 (clang-1205.0.22.11)] 

|>>> from platform import system 

|>>> print(system()) 


Darwin 
|>>> from platform import processor as a 8) 


You do not normally need to unimport a module or an object. Once you have imported a module or an 
object, Python retains access to it until you quit Python. 
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CHAPTER 3 


Getting Started 
with Variables 


In this chapter, you learn to work with variables, named areas of memory 
that you can use to store data as your apps run. You explore the different 
data types Python uses and learn how to use each data type effectively. 
Along the way, you create variables by assigning data to them, retrieve data 
from variables, change the contents of variables, and determine the data 
type of the values assigned to variables. 


® dictionaries11.py x 
C: > Users > guy > Dropbox > TYV_Python > Code > @ dictionaries11.py > ... 
dishes = {} 
dishes["Starters"] = { 
"Garlic Bread" : "$3.e0", 
“Spring Rolls” : "$4.58", 
“Soup of the Day" : "$2.5" 


dishes["Main Courses"] = { 
“Pizza” : "$7.50", 
“Lasagne” : "$10.08", 
“Bolognese” : "$5.50" 


} 
dishes["Desserts"] = { 
“Mousse” : "$4.00" 


"Ice Cream" : "$2.75" 
print("Starters:") 
for item in dishes["Starters"]: _ 


PROBLEMS OUTPUT © DEBUGCONSOLE TERMINAL Bjryhon +~ O WH ~ Xx 


Copyright (C) Microsoft Corporation. All rights reserved. 
Install the latest PowerShell for new features and improvements! https: //aka.ms/PSWindows 


PS C:\Users\guy> & "C:/Program Files/Python31@/python.exe" c:/Users/guy/Dropbox/TYV_Python/Code/dict 
ionariesi1.py 
Starters: 
Garlic Bread: $3.00 
Spring Rolls: $4.5¢ 
Soup of the Day: $2.50 
PS C:\Users\guy> I 
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Understanding Variables and Their Usage 


i this section, you learn the essentials of variables, which are named areas of memory that you 
can create for storing data while your Python code runs. 


Python supports various different data types, such as integers for whole-number values, Booleans 
for True/False values, and strings for words or other sequences of text characters. After creating 
a variable, you can assign any type of data to it that Python uses. See the following section, 
“Understanding Python's Data Types,” for details on Python’s data types. 


; ? 
What Is a Variable? Variable Name Variable Name Variable Name 


A variable is an area of 
acai Aa waren vam eae name~<€) age <() isOnProbat ion <@ 


store data. When you Contents Contents Contents 
create a variable, you 
give it a name that 
enables you to access it Current Data Type Current Data Type Current Data Type 
to retrieve or change its str int bool 

contents. When your 
code runs, Python 
allocates a space in memory for each variable. 


Anna Connor 27. True 


For example, you might create a variable called name to store an employee's name (A). The name would 
normally be a string of text characters, such as Anna Connor or Bill Ramirez, so the value would 
receive the str data type, which Python uses for strings. Similarly, you might create a variable called age 
to store the employee’s age in years as a whole number (B). That value would be an integer, so Python 
would assign the value the int data type that it uses for integers. Or you might create a variable called 
isOnProbation to store the employee's probation status (C). This variable would store the value True or 
the value False, and Python would assign the value the bool data type that it uses for Boolean values. 


A Variable Does Not Have a Data Type, But Its Value Does 


In Python, variables themselves do not have data types, so you do not specify the data type when you 
create a variable. Instead, the value assigned to the variable has a type. So instead of, say, creating a 
variable and giving it the int data type, which is for integers, you would create a variable and assign data 
of the int data type to it. 


This treatment of variables is called dynamic typing and is different from various other programming 
languages that enable — or require — you to give each variable a specific data type, a practice called static 
typing. For example, Microsoft's Visual Basic programming language encourages you to declare each variable 
explicitly and assign a data type. For instance, Dim intAge As Integer “dimensions” — creates — a 
variable called intAge that has the Integer data type and will accept only integer data. Such explicit 
declarations prevent you from putting the wrong type of data in a variable — trying to do so causes an 
error — and from overwriting the variable unintentionally by using the same name later in your code. 
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CHAPTER 


Getting Started with Variables 


Creating a Variable and Assigning x] File Edit Selection View Go Run Terminal Help Variables_1.py - Visual Studio Code 
Data to It ® Variables_l.py 


In Python, you create al variable and CG . ae > ok pe yp > Code > ® Variables_1.py >... 
assign data to it in a single statement. 2 


For example, consider the following line: Qe “a 


4 125 5 price = “noderate'}<QQ 
price = 


This line (A) declares a variable called 
price and initializes it by assigning the value 125 to it. This value is an integer, a number with no decimal 
component, so Python gives it the int data type. 


You can then change the value if needed, as in the following line: 
price = 250 
This line (B) assigns the value 250 to the price variable. 


You can also assign data of a different data type to the price variable. For example, the following line (C) 
assigns a string value: 


price = "moderate" 
Because the price variable does not have a static data type, it accepts the string value without comment. 


However, some IDEs display a warning when your code contains this kind of change, because it could 
represent an error, as a programmer would not normally change the data type contained in a variable. 


Seeing What Data and Data Type a Variable Contains [eee © guy — Python] 
[guy@Mac-Pro-7 ~ % python3 

: Python 3.10.0 (v3.10.0:b494f5935c, Oct 
print command to display the contents to the console. For |, ang-1205.0.22.11)] on darwin 


example, the following line (A) displays the contents of the |Type "help", "copyright", "credits" or " 


To see what data a variable contains, you can use the 


[>>> price = 125 

[>>> price 250 

print (price) [>>> price = "moderate" 
: [>>> print(price) 

The print command works fine for values that are text or moderate 

can easily be interpreted as text, but trying to print a ne type (price) 

variable containing binary data — for example, an image— |<< “5° “*" 


>> Ef 
will usually cause problems. 


price variable: 


To see what data type the value assigned to a variable has, you can use the type command with the variable’s 
name. For example, the following line (B) displays the data type of the value assigned to the price variable: 


type (price) 


This command returns the value’s class, such as <class ‘int'> for the int data type or <class 'str'> 
for the str data type. 
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Understanding Python’s Data Types 


ython includes various built-in data types designed for handling different types of data 

efficiently. For example, Python’s bool data type is designed for storing Boolean data, data that 
can be either True or False but no other possible value. Similarly, Python’s str data type is designed 
for storing strings of text. 


Python’s built-in data types mostly fall into six categories: numerics for numbers; sequences for data 
such as lists; mappings for dictionaries, where one item maps to another; classes for creating custom 
objects; instances for the objects created with those classes; and exceptions for handling errors. 


Understanding How Python Builds on the C Programming Language 


The Python programming language is primarily implemented using C, a long-standing and robust 
programming language that is still widely used across many industries. C is called a low-level programming 
language, which means that it can interface directly with hardware features, lending itself to software and 
operating-system development. C is relatively easy to understand but extremely hard to master. 


Python is a high-level programming language and includes many built-in features that C does not natively 
support, giving you an easier way to harness some of the power of C to develop solutions rather than using 
C directly. Python’s extensive feature set and capability to run well on many platforms contributes to its 
great versatility. 


Because Python is built on C, Python’s data types are constructed using combinations of C’s data types. For 
example, Python includes a data type called set that enables you to store multiple pieces of information in 
a single variable — a capability that C itself does not directly provide. Furthermore, some of Python’s more 
complex data types are constructed using simpler Python data types. 


Understanding the Numeric Data Types 
Python provides three main numeric types for handling different kinds of numeric data: 


e int. This data type is used for storing integer numbers — numbers that do not have a decimal compo- 
nent. For example, 0, 3, 42, and 4817 are all integers. The following section, “Work with Integers,” pro- 
vides examples of working with the int data type in Python. Technically, the bool data type for storing 
Boolean values is a subtype of int. 
float. This data type is used for storing floating-point numbers, those that have a decimal component. 
For example, 9876.54321 is a floating-point number. The section “Work with Floating-Point Values,” later 
in this chapter, gives you examples of working with the float data type in Python. 


54 
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Understanding the Numeric Data Types (continued) 


© complex. This data type is used for storing complex numbers — numbers that consist of a real 
component and an imaginary component. Complex numbers have mostly specialized uses beyond the 
scope of this book. 


Understanding the Sequence Data Types 


In Python, a sequence is a set of data that is ordered — in other words, it has a specific order. Some 
sequence data types are immutable, or unchangeable, whereas others are mutable, or changeable. 


The following list explains the main data types in the sequence category: 


e list. This data type contains a sequence of similar items — for example, a list of integers might con- 
tain 1, 2, and 3, ora list of strings might contain dog, cat, and snake. Lists are mutable, so you can 
change their contents, their order, or both. See the section “Start Working with Lists,” later in this 
chapter, for more about this data type. 
tuple. This data type is used to store an ordered sequence of values. The values do not need to be 
unique, so a tuple can contain multiple instances of the same value. A tuple is immutable, so you cannot 
change its contents or its order once you have created it. See the section “Work with Tuples,” later in 
this chapter, for more about this data type. 
range. This data type is used to contain an immutable sequence of integer values — for example, from 
1 to 10. Ranges are often used to control the number of iterations in for loops. 
str. This data type is used for storing strings of text. Python considers a string to be an immutable — 
unchangeable — sequence of characters. The section “Start Working with Strings,” later in this chapter, 
gets you started with the str data type, while Chapter 9, “Working with Text,” shows you the most use- 
ful moves with strings. 


continued 
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Understanding Python’s Data Types (continued) 


n addition to the sequence data types — list, tuple, range, and str — discussed so far in 
this section, Python provides a set data type for storing sets of data. A set is not a sequence 
because it does not have a specific order. 


Python also provides a single mapping data type, dict, which is used for creating dictionaries. A 
dictionary in Python is not a dictionary in the everyday sense, although there are some similarities 
between the two: A key in the dictionary maps to a particular value, enabling you to look up that value. 


Understanding the Set Data Type 
In Python, the set data type enables you to store multiple values in a single variable. The set data type 
has the following characteristics: 


It contains elements. The elements, also called members, are the discrete objects that make up the set. 
Each element is unique. A set cannot have duplicate elements. By contrast, a list or a tuple can have 


duplicate elements. 
It is unordered. The elements in a set have no specific order. This means you cannot refer to an element 


in a set by its index or position. 
It is immutable. Once you have created a set, you cannot change its existing items, but you can add 


further items to the set if you need to. 


The section “Work with Sets,” later in this chapter, gives you an example of creating and manipulating a set. 


Understanding the Mapping Data Type 

Python’s mapping category contains a single data type, dict, which is used for dictionaries. A dictionary 
consists of key/value pairs, with the key in each pair giving you access to set, retrieve, or modify the 
associated collection of information in the value. 


A dictionary is unordered; you access the data by supplying the appropriate key rather than an index value. 
A dictionary is mutable, so you can change its contents after creating it. 


The section “Start Working with Dictionaries,” later in this chapter, introduces working with dictionaries. 
Chapter 11, “Working with Lists and Dictionaries,” goes into dictionaries in depth. 
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Understanding Python’s Classes 


In Python, a class is a kind of template you use for creating a new object of a particular type. You can 
create a class object to organize the functions and other code in a particular project. 


That sounds nebulous, but if you work with office productivity software, you are likely used to a similar 
paradigm. For example, if you need to create many memos of the same type in Microsoft Word, you may 
create a custom memo template containing the layout and formatting for the memo, and perhaps some VBA 
code for automation. That memo template is analogous to a Python class. 


Chapter 12, “Working with Classes,” explains how classes work, tells you what classes are useful for, and 
shows you how to create a class and put it to use. 


Understanding the Instance Data Type 


In Python, an instance is an individual object created from a particular class. For example, say you create a 
class that contains the functions needed to run a particular data-aggregation and assessment task. When 
you want to work on that data, you create an instance of the class — or, to use the formal term, you 
instantiate the class. 


Continuing the previous example, when you need to produce a memo, you create a new document based on 
your memo template rather than using the memo template itself. The document is analogous to an instance 
of the template class. 


Chapter 12, “Working with Classes,” covers how to create and use instances of your custom classes. 


Understanding the Exception Data Type 

In Python, an exception is an object representing an error that occurred during code. Chapter 10, “Handling 
Errors,” shows you how to work with Python’s built-in exceptions to handle errors when they occur. This 
chapter also explains how to create custom exceptions. 
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Work with Integers 


ython provides the int data type for storing integer values. An integer is a whole number, one with 
no fractional component. For example, 1, 7, and 49 are integers, whereas 1% and 7.25 are not. 


In this section, you use the input () command twice to prompt the user to enter two integers. Each 
input () command returns a string that you convert to an integer by using the int () command. 
You then use the addition operator, +, to add the numbers; use the str() command to create a 
string from the result; and use the print () command to display that string. 


Work with Integers 


Create the Script J File Edit Selection View Go Run Terminal Help Integers_3.py - Visual Studio Code 
. . ® Integers_3.py X 
@ In Visual Studio Code, create a new script, :dillclSigag Seated THE Rotaract racer 


1 strNi = input(("Enter an integer: “)] 


and then save it. 


For example, press (2+), click Select 

a Language, and then click Python. Press 
(+, specify the filename and location, 
and then click Save. 


@ Type the following statement, which uses the 
input () command to prompt the user to 
enter an integer and assigns the result to 
a variable named st rN1: 


strN1 = input ("Enter an 
integer: ") 


3 ) Pres s Gx. and then ty pe the following J File Edit Selection View Go Run Terminal Help Integers_3.py - Visual StudioCode = — o x 
statement, which prompts the user to integers apy. x be Oo 
enter another integer and assigns it to a "= Makati <n o we 


1 strN1 = input("Enter an integer: 

s “i 2. strN2 = input("Enter another integer: 3) 
variable named strN2: 4 riciahgair J aeak 

4  intN2 = inert GD | 


strN2 = input ("Enter another 
integer: ") 


4) Press (=, and then type the following 
statement, which uses the int () command 
to convert strN1 to an integer and assigns 
it to a variable named intN1: 


intN1 = int (strN1) 
@ Press GG, and then repeat step 4, but 


this time convert st rN2 to an integer and 
assign it to intN2: 


intN2 = int(strN2) 
58 
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J File Edit Selection View Go Run Terminal Help Integers_3,py - Visual Studio Code = Oo x 


6 ) Press (ica, and then type the following 
statement, which adds intN1 and intN2, 
assigning the result to a variable named 
intTotal: 


® integers 3.py X Dy 


C: > Users > guy > Dropbox > TYV_Python > Code > @ Integers_3.py >... 
1 strN1 = input("Enter an integer: ") | saa 
2 strN2 = input("Enter another integer: ") 
3 intN1 = int(strN1) 
4 
5 


intN2 = int(strN2) 
intTotal = intN1 + ie 6) 
strTotal = str(intTotal) 7 


7 print(strna + "+" + strN2 + "=" 4 a 8 | 


intTotal = intN1l + intN2 


@ Press GTS), and then type the following 
statement, which uses the str() command 
to convert intTotal to a string: 


strTotal = str(intTotal) 


© Press GS), and then type the following 
statement, which uses the strings to 
display the calculation and its result: 


print (strN1 + "+" + strN2 + 
"=" + strTotal) 


Python 3.10.0 64-bit @O0A0 Ln7,Col44 Spaces:4 UTF-8 CRLF Python & QO 


Run the Script 
1) Click Run Python File in Terminal ([>). 


>) File Edit Selection View Go Run Terminal Help Integers_3.py - Visual Studio Code = Oo x 


® Integers 3.py x = 1) 


C: > Users > guy > Dropbox > TYV_Python > Code > @ Integers_3.py >... 

strN1 = input("Enter an integer: “) a 
strN2 = input("Enter another integer: ") 

intN1 = int(strN1) 

intN2 = int(strN2) 

intTotal = intN1 + intN2 7 
strTotal = str(intTotal) 

print(strn1 + "+" + strN2 + "=" + strTotal), 


@ The Terminal pane opens. 


@ The Terminal pane displays the details 
of the code it is running. 


Noun WnR 


The first prompt appears. 


(2 } Type a value and press (ne. 


The second prompt appears. 
3) Type another value and press Guo. 


@ The calculation and its result appear. 


PROBLEMS OUTPUT DEBUG CONSOLE A) 38 Python Debug Console + - [] i ~ x 


Copyright (C) Microsoft Corporation. All rights reserved. 
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows 


PS C:\Users\guy\Dropbox\TYV_Python\Code> & ‘C:\Program Files\Python31@\python.exe’ ‘c:\Users\guy 
\.vscode\extensions\ms-python. python-2021 .10.1365161279\pythonFiles\ li hon\debugpy\launcher” 
"52281" *--' ‘c:\Users\guy\Dropbox\TYV_Python\Code\Integers_3.py~ 

inter an integer: 125 

Enter another integer: 255 


PS C:\Users\gu C lox\TYV_Python\Ccode> ff 
Python 3.10.0 64-bit @O0A0 Ln7,Col44 Spaces:4 UTF-8 CRLF Python & O 


What does the + operator do in Python? 

With numerical values, Python uses the + operator for addition. For example, 1 + 2 adds 1 and 2, 
returning 3. See Chapter 5, “Working with Python’s Operators,” for more information about Python’s 
mathematical operators and other operators. 


With strings, Python uses the + operator for concatenation, which means joining the strings together. For 
example, "after" + "noon" joins after and noon, returning afternoon. When concatenating strings, you 
will often need to add spaces or punctuation between them. 
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Work with Floating-Point Values 


floating-point value is a value that includes both an integer part and a decimal part, such as 
6.155 or 0.1. In Python, floating-point values are often called floats. 


A floating-point number's value is represented in binary using two components, a mantissa and an 
exponent. The mantissa stores the binary value for the number, whereas the exponent specifies the 
position of the decimal point in the mantissa. This means that, while a float is an efficient means of 
storing a number that includes a decimal point, its accuracy can vary. 


Work with Floating-Point Values 


@ In Visual Studio Code, create a new script, and > file Edit Selection View Go Run Terminal Help floate11.py- Visual Studio . 


then save it. ® foatst1.py x 
: > Users > guy > Dropbox > TYV_Python > Code > @ floats11.py >.. 
7 1 degF = input("Enter the Fahrenheit temperature: " 
For example, press G-@. click Select 2 result = degF + " degrees Fahrenheit is " 


a Language, and then click Python. Press 
(+, specify the filename and location, 
and then click Save. 


@ lype the following statement, which prompts 
the user to enter the Fahrenheit temperature, 
assigning the result to the variable degF: 
degF = input ("Enter the Fahrenheit 


temperature: ") 


© Press GET) and type the following statement, 
which assigns the input () command's string and 
explanatory text to a variable named result: Python 310064bit @OAO > 


result = degF + "degrees 
Fahrenheit is " 

@ Press GEE and type the following statement, 
which converts the input () command's string 
to a float data type: 


@ floats11.py X Dy. O-: 


C: > Users > guy > Dropbox > TYV_Python > Code > @ floats11.py > ... 
1  degF = input(“Enter the Fahrenheit temperature: ") 


result = degF + " degr Fahrenheit is " 

degF = ricat cost QQ) 

degC = degF - 32 rm 
degC = degC * | 


degF = float (degF) 


e Press (&@39 and type the following statement, 
which subtracts 32 from the float value in 
degF and assigns the result to the variable 
named degC. 


degC = degF - 32 


@ Press GED and type the following statement, 
which multiplies the value in degc by 5: 


Python 3.10.0 64-bit @o0A0 > Ln 5,Col 16 Spaces: 4 CRLF Python & O 


degC = degc * 5 
60 
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Press (GG and type the following statement, 
which divides the value in degc by 9: 
degC = 


6 Press (S09 and type the following 
statement, which rounds the degc value 
down to one decimal place: 


degc / 9 


degC = round(degC,1) 


9 ) Type the following statement, which derives 
a string from the degc value and adds that 
string and further explanatory text to the 
existing string in the result variable: 


result = result + str(degC) + " 


degrees Celsius." 


€ Press GED and type the following 
statement, which uses the print () 


command to display the contents of the 
result variable: 


print (result) 
@ Click Run Python File in Terminal ([>). 
@ The Terminal pane opens. 


@ The Terminal pane displays the details of 
the code it is running. 


The first prompt appears. 
The input () prompt appears. 
® Type a Fahrenheit temperature and press Gio. 
@ The result appears. 


TIP 


CHAPTER 


Getting Started with Variables 


® floatsi1.py x 


C; > Users > guy > Dropbox > TYV_Python > Code > @ floats11.py >.. 

2 degF = input("Enter the Fahrenheit temperature: ") 
2 result = degF + " degrees Fahrenheit is " 

3 degF = float(degF) 

4 degC = degF - 32 

5S degC = degC * 5 


6 degC = degC / > 7) im 
(8 ew = round(degC,1) 
8 result = result + str(degc) + " degrees ceisius. GD 


Python 3.10.064-bit @OAO0 Ln 8,Col50 Spaces:4 UTF-8 CRLF Python & O 
J File Edit Selection View Go Run Terminal Help floats11.py- Visual Studio... — Oo x 
® floatsi1py x 11 oe ~-O- 


C; > Users > guy > Dropbox > TYV_Python > Code > @ floats11.py >... 
degF = input("Enter the Fahrenheit temperature: ") 
result = degF + " degrees Fahrenheit is " 

degF = float(degF) 

degC = degF - 32 

degC = degC * 5S | 
degC = degC / 9 
degC = round(degC,1) 


result = result +, (degC) + " degrees Celsius." 
princes) Qh) 


PROBLEMS OUTPUT DEBUG CONSOLE rena QE Yjrres cers corse +-Ow*x 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWind 
ows 


OMNANRWNHR 


B PS C:\Users\guy\Dropbox\TYv_Python\Code> & ‘C:\Program Files\Python31@\python.exe’ ‘c 
: \Users\guy\ .vscode\extensions \ms-python. python-2021 .18.1365161279\pythonFiles\lib\pyt 
hon\debugpy\launcher’ "58904" "--' i 1: ne 


Enter the Fahrenheit temperature: 98.4 
98.4 degrees Fahrenheit is 36.9 degrees Celsius= 
PS C:\Users\guy\Dropbox\TYV_Python\Code> ff 


Python 3.10.064-bit @OAO0 Ln9,Col14 Spaces:4 UTF-8 CRLF Python 


Can you write the calculation using fewer lines? 
Yes — you can write the calculation in a single line, and doing so is more efficient. This example shows the 
calculation steps on separate lines for ease of reading. 


A more condensed version of this calculation is degC = (degF - 32) * 5 / 9. 


While condensing code is generally helpful, make sure your code is readable to anyone who will need to 
work on it. If in doubt whether your code is readable, document it by adding comments. 
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Work with Boolean Values 


Boolean value has only two possible states: True and False. The keywords True and False 
must use an initial capital followed by lowercase letters; other casing causes errors. 


Boolean values are useful for checking status and making decisions in code. You can use the bool () 
function to determine whether a particular value is True or False. For example, if a particular value 
is True, the code takes certain actions; otherwise — since that value must be False — the code 
takes other specific actions. You can use the logical operators and, or, and not to create complex 


Boolean expressions. 


Work with Boolean Values 


e Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ lype the following statement, which creates 
a variable named number1 and assigns the 
value 10 to it, and then press GG): 


numberl = 10 


(3 ) Type a similar statement to create a variable 
named number2 and assign the value 10 to 
it too, again pressing (@{e9 to complete the 
command: 


number2 = 10 


@ Type the following statement and press 
(359 to display the result of testing 
whether number1 equals number2: 


print (numberl==number2) 


Note: Python uses == to compare equality. It 
uses = for assigning values, as in step 3. 


@ Python returns True, the Boolean result for 
the comparison. 


Type the following statement and press 
(2353 to display the result of testing 
whether number2 is greater than number1: 


print (number2>number1) 


@ Python returns False, the Boolean result 
for the comparison. 
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|Formation. 
>> number1 
>> number2 
>> 


>> numberl = 
>> number2 = 
>> print (number1==number2 


‘ommand Prompt - python3 = o x 
: \Users\Guy>python3 
ython 3.9.7 (tags/v3.9.7:1016ef3, Aug 30 2021, 20:19:38) [M 
C v.1929 64 bit CAMD64)] on win32 

pe "help", “copyright", "credits" or "license" for more in 


s~<@ 
10 


1H Command Prompt - python3 - o x 


: \Users\Guy>python3 

ython 3.9.7 (tags/v3.9.7:1016ef3, Aug 30 2021, 20:19:38) [M 
Cc v.1929 64 bit (AMD64)] on win32 

ype "help", "copyright", “credits” or "license" for more in 
|Formation. 
10 
10 


rue 
>> print(Cnumber2>number1). 
False 

>> 


July 1, 2022 9:11 PM 
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6 } Type the following statement and press (jj to 


create a variable named are numbers equal and 
assign to it the result of testing whether number1 


equals number2: 
are numbers equal = numberl==number2 


7 ) Type the following statement and press (270%) to 
display the type of the are numbers equal 
variable: 


type (are numbers equal) 


@ The type appears. 


© Type the following statement and press @IGy to 
display the value of the are numbers equal 
variable: 


print (are _numbers_ equal) 
@ The value appears. 


© Type the following statement and press GE to 
toggle the value of the are numbers equal 
variable: 


are numbers equal = not are _numbers_ 
equal 


(10) Type the following statement and press (je to 
display the value of the are numbers equal 
variable: 


print (are numbers equal) 


@ The value appears. 


Which values evaluate to the Boolean False? 
Python returns a Boolean False value for the following values: 


e The value False or the value None 
e The number zero, 0 


CHAPTER 


Getting Started with Variables 


1H Command Prompt - python3 


: \Users\Guy>python3 
ython 3.9.7 (tags/v3.9.7:1016ef3, Aug 30 2021, 20:19:38) [M 
C v.1929 64 bit CAMD64)] on win32 

pe “help", "copyright", “credits” or “license” for more in 


>> print (number1==number2) 


rue 
= print (number2>number1) 
se 


>> are_numbers_equal = nurberiecrunber2 QQ 
>> type (are_numbers_equal 
class "bool'> 


>> print(are_numbers_equal) 
ru ! 
a ~ > 


i Command Prompt 


:\Users\Guy>python3 
ython 3.9.7 (tags/v3.9.7:1016ef3, Aug 30 2021, 20:19:38) [M 


>> print (number1==number2) 

rue 

>> print (number 2>number1) 

‘alse 

>> are_numbers_equal = number1==number2 
>> type (are_numbers_equal) 


class ‘bool'> 
>> print(are_numbers_equal) 


rue © 
>> are_numbers_equal = not are. lbers_equa 

= prinlara raters so ag) 

‘alse 


>> quitQ) if are_numbers_equal False else print(are_numb 
essai 11) 
:\Users\Guy>S 


€@) Type the following statement and press GIy to 


compare the are_numbers_ equal variable to 
False; to quit Python if they match; and, if not, 
to display the value of are numbers equal: 


quit() if are _numbers equal == False 


else print (are _numbers_ equal) 


Python quits. 


@ The terminal's standard prompt appears. 


e Anempty string, empty list, empty tuple, or empty dictionary 


Python returns a Boolean True value for all other values. True has a numeric value of 1. 
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Work with Tuples 


pytnon provides several data types that are sequences, including tuples, lists, strings, and sets. A 
tuple is a variable that stores an ordered sequence of values. Unlike a list, whose contents and 
order you can change, a tuple is immutable, so you cannot change its contents or its order. Unlike a 
set, a tuple can contain multiple instances of the same value. Tuples are useful for grouping related 
information that you want to be able to use as a single item. 


In this section, you use a terminal window to create and manipulate tuples. 


Work with Tuples 


@ Open a terminal window and launch Python. TT ee eT 
| guy@Mac-Pro-3 ~ % python3 
@ The Python prompt appears. Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 


[Clang 6.0 (clang-600.0.57)] on darwin 
n % Type "help", "copyright", "credits" or "li e" for more information. 
@ Type the following statement, which creates (Jrep>>orrices’= (rattantay,"eridgepore”, ee | 
|... "Chicago","Chicago","Denver") 


a variable named of fices and assigns to it >>> 
a tuple of five cities, and press GG: 


offices = ("Atlanta","Bridgeport", \ 
"Chicago", "Chicago", "Denver" ) 


Note: You can create an empty tuple by placing 
a pair of parentheses with no contents after 
the tuple’s name — for example, 
myEmptyTuple = (). 


3 ) Type the following statement, 
which displays the tuple’s 
contents, and press Gilca: 


eee ™ guy — Python — 70x23 

lguy@Mac-Pro-3 ~ % python3 = 
Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 

[Clang 6.0 (clang-600.0.57)] on darwin 

Type "help", "copyright", "credits" or "license" for more information. 
I>>> offices = ("Atlanta","Bridgeport",\ J 
|... "Chicago","Chicago","Denver") ] 


print (offices) 


Note: When creating a tuple that 
contains only a single item, you 
must use a trailing comma, a 
comma placed after the item. For 
example, mySingleTuple = 
(1,) creates a tuple containing 
only the value 1. 


>> print(offices) 
('Atlanta', 'Bridgeport', 'Chicago', 'Chicago', 'Denver') =<) 
>>> | 


@ The tuple’s contents appear. 
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4 ) Type the following statement, which displays 
the first item in the tuple, and press (=): 


print (offices [0] ) 
@ The first item appears. 


5) Type the following statement, which uses 
the len() function to return the number 
of items in the tuple, and press G3: 


print (len(offices) ) 
@ The number of items, 5, appears. 


6 ) Type the following statement, which 
displays the number of instances of the 
item "Chicago" in the tuple, and then 


press GG: 


print (offices.count ("Chicago") ) 


@ The number of instances of "Chicago", 2, 
appears. 


@ Type the following statement, which uses 
the del command to delete the tuple, 


and then press (jeu): 


del offices 


6 To verify that the tuple is gone, type the 
following print command, and then press 


je 


print (offices) 


@ Python returns an error because the tuple no 


longer exists. 


Can I add items to or remove items 
from a tuple? 
Technically, no, because the tuple is 


immutable. However, you can achieve the 
same effect by converting the tuple to a 
list, adding or removing the items, and 
then converting the list back to a tuple. 
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eo0e guy — Python — 70x23 
| guy@Mac-Pro-3 ~ % python3 
Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 
[Clang 6.0 (clang-600.0.57)] on darwin 
Type "help", "copyright", "credits" or "license" for more information. 
[>>> offices = ("Atlanta","Bridgeport", \ 
» "Chicago","Chicago","Denver") 
[>>> print(offices) 
(‘Atlanta', 'Bridgeport', 'Chicago', 'Chicago', 'Denver') 
[>>> print (offices [0] ). 


[>>> Print lantorhless) gaia 
5 


eco guy — -zsh — 70x23 
guy@Mac-Pro-3 ~ % python3 
Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 
[Clang 6.0 (clang-600.0.57)] on darwin 
Type "help", "copyright", "credits" or "license" for more information. 
>>> offices = ("Atlanta","Bridgeport",\ 
« "Chicago","Chicago","Denver") 
>>> print (offices) 
(‘Atlanta', 'Bridgeport', 'Chicago', 'Chicago', 'Denver') 
>>> print(offices[0]) 
Atlanta 
>>> print(len(offices) ) 


§ 
Gy» print (offices.count ("Chicago") 6) 
2 


>> del offices 
>> print(offices) 
Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
NameError: name 'offices' is not derinei <> 


>>> 


Why would I create an empty tuple? 

You might create an empty tuple to indicate that no data 
was available for a particular item or category. For example, 
if you were creating one tuple for each of 20 categories, 
having empty tuples where no data was available might be 
helpful. Otherwise, if you were creating only a single tuple, 
creating it with no data would be largely useless. 
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Work with Sets 


Pytron® set data type enables you to store multiple values in a single variable. A set is a 
collection of objects, usually called elements or members. Each element must be unique in the 
set, without duplicates, unlike in a tuple, which can have duplicates. Also unlike a tuple, a set is 
unordered — that is, it has no specific order. A set is immutable: After creating a set, you cannot 
change its existing items, but you can add further items as needed. In this example, you use a set to 
remove duplicate values from a tuple. 


Work with Sets 


In Visual Studio Code, create a new script, 
and then save it. 


For example, press i+, click Select a 
Language, and then click Python. Press 
(+, specify the filename and location, 
and then click Save. 


J File Edit Selection View Go Run Terminal Help  sets3.py-VisualStudioC.. — oO x 


® sets3.py xX py O- 


: > Users > guy > Dropbox > TYV_Python > Code > @ sets3.py 


1 mySet = ‘ _ y | 


@ Iype the following statement to create a variable 
named mySet and assign an empty set to it: 


mySet = set() 


Python 3.10.0 64-bit @o0A0 Ln1,Col14 Spaces:4 UTF-8 CRLF Python & O 


Press Gi. and then type the following 4 File Edit Selection view Go Run Terminal Help scu3py-ViualSwdoc. — OF x 
statement to create a variable named myTuple petoayy ba ates Wee Se er py O- 
. . 5 r * > Users > guy > Dropbox > /_Python > Code sets3.py > : 
and assign to it various numbers, including 1 mySet = set() Bae 
: 2 myTuple = eo 3 | 

duplicates: 3 3,3,3,4,4,4,4,5,5,5,6,6,7) 
4 Set. update(myTuple) 1 
myTuple = (1 Th, Pei D. ob 53 \ 5 print(""myTuple: “ + str(myTuple)) 

3,3,3,4,4,4,4,5,5,5,6,6,7) 


@ Press GHB, and then type the following 
statement, which uses the update method to add 
the unique values from myTuple to mySet: 


mySet .update (myTuple) 


e Press (@j@3, and then type the following 
statement, which displays the text myTuple:, 
a space, and a string containing the contents of 
myTuple: 


Python 3.10.0 64-bit @0A0 > Ln 5,Col34 Spaces:4 UTF-8 CRLF Python & O 


print ("myTuple: " + str(myTuple) ) 
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J File Edit Selection View Go Run Terminal Help  sets3.py-VisualStudioC.. — Oo x 


@ Press GEGB, and then type the following 


statement, which displays a blank line in @ sets3py x pv O- 
. C: > Users > guy > Dropbox > TYV_Python > Code > @ sets3.py >... 
the output: 1  mySet = set() wee. 
; 2 = myTuple = (1,1,1,1,1,2,2,2,2,3,\ 
print () 3 3,3,34414,4,4,5,5,5,6,657) 
4 = mySet.update(myTuple) 
S 


® Press (@ic3, and then type the following 
statement, which displays the text 
mySet:, a space, and a string containing 
the contents of mySet: 


print("myTuple: “ + str(myTuple)) 
Qi 1 | 
7 print("mySet: “+ seecnyset) QD 


print ("mySet: " + str(mySet) ) 


Note: The print () statements for myTuple 
and mySet use the str() function to cast 
the contents of myTuple and mySet to 
strings because the first item printed is a 
string. Using print ("mySet: " + 
mySet) causes an error from trying to 
concatenate a string and a set. 


Python 3.10.064-bit @O0A0 Ln7,Col30 Spaces:4 UTF-8 CRLF Python & Q 


>) File Edit Selection View Go Run ‘Terminal Help  sets3.py-VisualStudioC.. — Oo x 


® sets3py x oe = (ibe 


C: > Users > guy > Dropbox > TYV_Python > Code > @ sets3.py >... 

1 = mySet = set() pee 
2 myTuple = (1,1,1,1,1,2,2,2,2,3,\ 
3 | 3,3,3,4,4,4,4,5,5,5,6,6,7) | 
4 mySet.update((myTuple) 
5 
6 
7 


© Click Run Python File in Terminal ([>). 


Visual Studio Code runs the script. 
print("myTuple: “ + str(myTuple)) 
print() 

print("mySet: “ + str(mySet)) 


@ The contents of myTuple appear. 
@ The contents of mySet appear. 


You can see that mySet contains only the 
unique elements from myTuple — all the 
duplicates are gone. 


PROBLEMS OUTPUT  DEBUGCONSOLE TERMINAL Ejeyhon +~ O fH *~ Xx 


Copyright (C) Microsoft Corporation. All rights reserved. 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWind 
ows 


PS C:\Users\guy> & "C:/Program Files/Python31@/python.exe” c:/Users/guy/Dropbox/TYV_Py 
thon/Code/sets3.py 
yTuple: (1, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 6, 6, 7) 


mySet: {1, 2, 3, 4, 5, 6, Za B) 
PS C:\Users\guy> fj 


Python 3.10.064-bit @O0A0 Ln4,Col22 Spaces:4 UTF-8 CRLF Python & O 


TIP 


How do I create a set with contents? 

You can create a set with contents in either of two ways. First, put the set’s items inside braces, separated 
by commas — for example, fruitSet = {"apricot", "berry", "cucumber"}. Second, use the set () 
function, as in the main text, to create a set from a list or a tuple. For example, if you have a list called 


testMarks that contains duplicate values, you could create a variable named uniqueMarks and assign to 
it a set of the unique values from testMarks by using the command uniqueMarks = 
set (testMarks). 
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Start Working with Strings 


T: store and manipulate text in your scripts, you use strings. In Python, a string is an immutable 
sequence of characters, so once you have assigned a string to a value, you cannot change it. A 
string value has the str data type, and you can use the str() function to convert various other 


data types to strings. 


Chapter 9, “Working with Text,” shows you how to take widely useful actions with strings. This section 
provides an introduction to strings. In it, you create and manipulate strings using a terminal window. 


Start Working with Strings 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ Iype the following statement, which creates a 
variable named stri and assigns text to it, and 


then press GG: 


strl = "Industry" 


Type the following statement, and then press 
(GSD, to display str1: 
print (str1) 


@ The string appears. 


@ Iype the following statement, and then press 
(@NU53. to create a second string: 


str2 = "Assessment" 


Type the following statement, and then press 
(GNS3. to display stra: 
print (str2) 

@ The string appears. 


6 } Type the following statement, which uses the + 
operator to concatenate, or join, stri and str2, 
adding a space between them and assigning the 
result to str1. Again, press IG). 


strl = strl-+ " " + str2 


Type the following statement, and then press 
(GSD, to display str1: 
print (str1) 


@ The string appears. 
68 
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eee guy — Python — 65x24 =<) 

Last login: Mon Sep 27 16:46:10 on ttys003 
|guy@Mac-Pro-4 ~ % python3 

Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 
[Clang 6.0 (clang-600.0.57)] on darwin 


tion. 
>> strl = rindustry aa 
>>> print(str1) 


Industr 
>>> ff 


Type "help", "copyright", "credits" or "license" for more informa 


eo0o ™ guy — Python — 65x24 
Last login: Mon Sep 27 16:46:10 on ttys003 
guy@Mac-Pro-4 ~ % python3 

Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 
[Clang 6.0 (clang-600.0.57)] on darwin 


Type "help", "copyright", "credits" or "license" for more informa 


tion. 
>>> strl = "Industry" 
>>> print(str1) 


Industry 
>>> str2 = *Assessment @@Q 
>>> aii 5 | 
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6 Type the following statement, which 
uses the find method to locate 
the position of the space in str1, 
assigning the result to a variable 
called intSplit. Press G@@y. 


intSplit = strl.find(" ") 


© Type the following statement, and 
then press 0, to display the value 
of intSplit: 


print (intSplit) 
@ The value appears. 


© Type the following statement, and 
then press (0, to create a variable 
named strWord1 and assign to it 
the leftmost characters in str1, up 
to the space: 


strWordl = str1[0:intSplit] 


@®) Type the following statement, and 
then press GG, to display the 
string in strWord1: 


print (strWord1) 


@ The string appears. 
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eee GB guy — -zsh— 65x24 

Last login: Mon Sep 27 16:46:10 on ttys003 
guy@Mac-Pro-4 ~ % python3 

Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 
[Clang 6.0 (clang-600.0.57)] on darwin 

Type "help", "copyright", "credits" or "license" for more informa 
tion. 

>>> strl = "Industry" 

>>> print(str1) 

Industry 

>>> str2 = "Assessment" 

>>> print(str2) 

Assessment 

>>> strl = strl +" "+ str2 

>>> print(str1) 

Industry Assessment 


>>> intSplit = 0 " "—<& 


E >>> print(intSplit 
>>> strWordl = stri[o:intsplitl<ly) 


>>> 


eee GD guy — -zsh— 65x24 

Last login: Mon Sep 27 16:46:10 on ttys003 

guy@Mac-Pro-4 ~ % python3 

Python 3.9.6 (v3.9.6:db3ff76dal, Jun 28 2021, 11:49:53) 

[Clang 6.0 (clang-600.0.57)] on darwin 

Type "help", "copyright", "credits" or "license" for more informa 
tion. 

>>> strl = "Industry" 

>>> print(str1) 

Industry 

>>> str2 = "Assessment" 

>>> print(str2) 

Assessment 

>>> strl = stri +" i + str2 

>>> print(str1) 

Industry Assessment 

>>> intSplit = stril.find(" ") 

>>> print(intSplit) 

8 


>>> strWordl = str1[O:intSplit] 
>>> print (strword1 =) 


QPrpncusery 


>>> 


Do I use single quotes or double quotes around a string? 
In Python, you can use either single quotes or double quotes to delimit a string. For example, you could 
assign text to the variable named myString by using either myString = 'sample text’ or myString 


"sample text". Use single quotes if the string contains double quotes, such as myString = 'Text 
with "double" quotes'; use double quotes if the string contains single quotes, such as myString = 


"Text with 'single' quotes". Otherwise, use whichever you prefer. 
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Start Working with Lists 


list is a variable that enables you to store multiple items of the same type or of different types. 
The list contains an index that enables you to set or retrieve the individual items. Technically, a 
list is a mutable sequence, so you can change the order of its items, add and remove items, sort the 


items, and so on. 


Chapter 11, “Working with Lists and Dictionaries,” shows you how to work with lists. This section 
gives you a preview in which you create a list, add items to it, and return items from it. 


Start Working with Lists 


@ In Visual Studio Code, create a new script, and then 


save it. 


For example, press (@%)+(§, click Select a Language, 
and then click Python. Press (+), specify the 
filename and location, and then click Save. 


@ Type the following statement, which creates a 
variable called names and then assigns a list 
of four names to it: 


names = ["Anna", "Bill", "Carly", 
"Dennis"] 


© Type the following statement, which displays 
the first item in the list: 


print (names [0] ) 
@ Click Run Python File in Terminal ([>). 
The Terminal pane opens. 


@ The first list item appears. See the tip for 
information about the numbering. 


© lick Kill Terminal (ji). 
Visual Studio Code closes the Terminal pane. 


Select the print (names [0]) statement and type 
the following statement over it, using the append 
method to add an item to the names list: 


names.append ("Frank") 


Press (ico and type the following statement, 
which displays the fifth item in the list: 


print (names [4] ) 


70 


0005377494.INDD 70 Trim size: 7.375 in x 9.25 in 


J File Edit Selection View Go Run Terminal Help _ lists2.py-- Visual Studio C... 


® lists2py x 
C: > Users > guy > Dropbox > TYV_Python > Code > @ lists2.py 
1 names = ["Anna”,"B a 2 | 


2 a. 


PROBLEMS OUTPUT © DEBUG CONSOLE TERMINAL 


Windows PowerShell 
Copyright (C) Microsoft Corporation. All rights reserved. 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWind 
ows 


PS C:\Users\guy> & “C:/Program Files/Python31@/python.exe” ¢:/Users/guy/Dropbox/TW_Py 
thon/Code/lists2.py 

Anna 

PS C:\Users\guy> ff 


® lists2py x 


C: > Users > guy > Dropbox > TYV_Python > Code > @ lists2.py > 


PROBLEMS OUTPUT © DEBUG CONSOLE TERMINAL 


Windows PowerShell 
Copyright (C) Microsoft Corporation. All rights reserved. 


Install the latest PowerShell for new features and improvements! https: //aka.ms/PSWind 
ows 


PS C:\Users\guy> & "C:/Program Files/Python31@/python.exe" ¢:/Users/guy/Dropbox/TW_Py 
thon/Code/lists2.py 

‘rank 

PS C:\Users\guy> ff 


on 3.10.0 64-bit @oAo0 > 


@ Click Run Python File in Terminal ([>). 


The Terminal pane opens. 


© The fifth list item appears. 
@ Click Kill Terminal (jij). 
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Visual Studio Code closes the Terminal pane. 


(10) Click at the end of line 2 and press 
(2353 to start a new line, moving the 
print (names [4] ) line down from line 
3 to line 4. 


J File Edit Selection View Go Run Terminal Help _ ists2.py-VisualStudioC.. — Oo x 


® lists2py x DP. O-: 
C: > Users > guy > Dropbox > TYV_Python > Code > @ lists2.py > .. 


1 names = ["Anna”,"Bill”,"¢ ", "Dennis" ] — 
2 names. append("Frank” 
Dp vores inserts, "eni2y") 


4  print(names[4] 1 | 


@ 0n the empty line 3, type the following 
statement, which uses the insert method 
to insert an item at position 4 in the list: 


names.insert (4, "Emily") 


@ Click at the end of line 4 and press G@NGB 
to start a new line. 


Python 3.10.064-bit @OA0 Ln4,Col16 Spaces:4 UTF-8 CRLF Python & Q 


J File Edit Selection View Go Run Terminal Help _ ists2.py-VisualStudioC.. — Oo x 


® lists2py x 15 ad -O-. 


C: > Users > guy > Dropbox > TYV_Python > Code > @ lists2.py > .. 
1 names = ["Anna”,"Bill”,"Carly", "Dennis" ] ~ 
2 names. append("Frank") 
3 names. insert(4, Emily”) 


® Type the following statement, which uses 
the remove method to remove the name 
Bill from the list: 


names .remove ("Bill") 


® Finally, press (09 and type another 
print (names [4] ) statement: 


4  print(names[4]) 7 
(13 ee .remove("Bill” 
6 print(names[4] 


print (names [4] ) 


© Click Run Python File in Terminal ([>). 


PROBLEMS OUTPUT  DEBUGCONSOLE TERMINAL EjJeython ++ O HH ~*~ x 


The Termin n ns. Windows PowerShell 

€ le al pa € ope s Copyright (C) Microsoft Corporation. All rights reserved. 

Install the latest PowerShell for new features and improvements! https://aka.ms/PSWind 
ows 


@ The first print statement displays the fifth 


name, Emily. 
ame, y PS C:\Users\guy> & “C:/Program Files/Python31@/python.exe" c:/Users/guy/Dropbox/TYV_Py 
thon/Code/lists2.py 


@ The second print statement displays the 
fifth name after removing the Bill item, 


Frank. 


Python 3.10.064-bit @OA0 Ln6,Col16 Spaces:4 UTF-8 CRLF Python & O 


Why is the first list item numbered 0? 


Starting to count at 0 rather than 1 is a convention of computing; the technical name is zero-based 
numbering. So names [0] is the first item in the names list, names [1] is the second item, and so on. 
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Start Working with Dictionaries 


[ Python, a dictionary is a kind of super-list that allows you to assign collections of information to 
names called keys. You use a key to set, modify, or retrieve the associated collection of information. 


Chapter 11, “Working with Lists and Dictionaries,” shows you how to work with dictionaries. This 
section gives you an introduction to dictionaries. Here, you create a dictionary that contains 
information about the dishes offered by a restaurant. The dishes fall into three categories: Starters, 
Main Courses, and Desserts. You then display the category of dishes you want to see. 


Start Working with Dictionaries 


1 ) In Visual Studio Code, create a new script, and then save it. XJ File EA Selecion View Go Rin = efonarestipy- Vs Sua. 
® dictionaries11.py < 
For example, press G+. click Select a Language, tes ew to 2 Code > ® dictionaries 1.py 
and then click Python. Press @%)+(G3), specify the filename jsearite Breed" = "$3.007 


. re “Spring Rolls” : “$4.5e", 
and location, and then click Save. |. oF the Day" 3) 
@ Iype the following statement, which declares a 
dictionary named dishes: 
dishes = {} 


© Press GHG) and type the following statements, which 
add the category called Starters and assign three 
items and their prices to it: 


dishes["Starters"] = { 


File Edit Selection View Go Run --- dictionaries 1.py - Visual Studi... = — Oo x 


"Garlic Bread" : "$3.00", Be escnshiay x >be O- 
" Spring Rolls" : " $4 <5bO", c seas > uy — > TYV_Python > Code > @ dictionariest1.py = 
1 dishes = Se 
"Soup of the Day" : "$2.50" SPs tw. ‘i 
} 4 “spring Rolls” : "$4.50", 
5 “Soup of the Day” : "$2.50" 
6 
4 Press (@e9 and type the following statements, which 3 pisses 87-56", ' 
. ® “Lasagne” : "$10.00", 
add the category called Main Courses and assign » | “eologrese™ : "$5.50 7 
three items and their prices to it: ae il ese O 
14 eae — "BS 
dishes["Main Courses"] = { ri io am >) 
"Pizza" : "$7.50", 
"hasagne" : "$10.00", 
"Bolognese" : "$5.50" 


@ Press GIS9 and type the following statements, which add 
the Desserts category, again with three priced items: 


dishes["Desserts"] = { 
"Mousse" : "S4.00", 
"Lemon Sorbet" : "$3.50", 
"Tce Cream" : "$2.75" 

} 
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J File Edit Selection View Go Run -- dictionaries11.py - Visual Studi... = — Oo x 


@ Press GED and type the following 
statement, which displays the word 
Starters and a colon: 


® dictionaries11.py DP. O-: 


C: > Users > guy > Dropbox > TYV_Python > Code > @ dictionaries11.py > ... 
dishes = {} Bev. 
dishes["Starters"] = { 


(0% 


print ( "Starters:" ) "Garlic Bread" : "$3.00", 
“Spring Rolls” : "$4.58", 
. = *F the Day” : "$2.50" 
@ Press GED and type the following iced : tae 
statements, which use a for loop to list Pe 
7 1 . “Lasagne” : "$10.00", 
each dish in the Starters category: eae 
; ; ; } 7 
for item in dishes["Starters"]: dishes[“Desserts"] = { 
print ( " " 4 dtem + ":" “Mousse” : "$4.00", 
a a “Lemon Sorbet” : "$3.58", 
dishes ["Starters"] [item] ) 45 “Ice Cream" : "$2.75" 
ae) 
Note: A for loop is a loop that repeats once res 
for each item in a collection — in this case, / _ ea ee ee ee 
once for each item in the Starters collection 
in the dishes dictionary. Chapter 7, 
“Repeating Actions with Loops,” explains for Python 3.10.0 64-bit @oAo0 > Ln 19,Col55  Spaces:4 UTF-8 CRLF Python & QO 
loops in detail. J File Edit Selection view Go Run -- dictionaries11.py -VisualStudi.. — O X 


® dictionaries11.py x 1) 


C: > Users > guy > Dropbox > TYV_Python > Code > @ dictionaries11.py > ... 
1 dishes = {} ae 


Run the Script 


@ Click Run Python File in Terminal ([>). 2 dishes["starters"] ={ me 
3: Garlic Bread” : "$3.00", 
z 4 “Spring Rolls” : "$4.5", 
The Terminal pane opens. 5 “Soup of the Day” : "$2.5@" 
6 } 
@ The list of starters appears. ..) eee | 
9 “Lasagne” : "$10.00", 
18 “Bolognese” : "$5.50" 
a} 
PROBLEMS OUTPUT  DEBUGCONSOLE TERMINAL Bjeython +~ O ~*~ X 


Install the latest PowerShell for new features and improvements! https://aka.ms/PSWind _ 
ows 


PS C:\Users\guy> & "C:/Program Files/Python318/python.exe” c:/Users/guy/Dropbox/TYV_Py 
thon/Code/dictionariesi1.py 
Starters: 

Garlic Bread: $3.00 


Spring Rolls: $4.58 
Soup of the Day: A] 
PS C:\Users\guy> fj 


Python 3.10.064-bit @OA0 Ln 19,Col55 Spaces:4 UTF-8 CRLF Python & O 


How do I change the code to display another collection? 
In lines 17-19, replace Starters with Main Courses or Desserts, aS appropriate. Here is an example: 


print ("Desserts") 
for item in dishes["Desserts"] 


print " " + item + ":", dishes["Desserts"] [item] 
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Convert Data from One Type to Another 


L your Python programming, you will often need to convert data from one data type to another 
so that you can use it the way you want. Python converts some data automatically and provides 
functions for converting data manually. For example, you can use the str() function to convert 
data to a string, use the int () function to convert numeric data to an integer, or use the float () 
function to convert numeric data to a float, as you have seen so far in this chapter. 


This section summarizes the data-conversion functions Python provides and shows examples of using 
them. 


Understanding Implicit Conversion and Explicit Conversion 
Python performs two types of data conversion: implicit conversion and explicit conversion. 


Implicit conversion occurs when Python automatically converts an existing value to a different data type to 
avoid losing data. For example, if you create a variable named intTest and assign the integer value 1, 
Python gives the value the int data type. But if you add a float, such as 3.19, to int Test, Python 
changes the value’s data type to float so as not to lose the data that could not be stored in the int data 
type. 


Explicit conversion occurs when you use a data-conversion function to convert data to a different type, as 
explained in this section. Explicit data conversion is also called type casting or simply casting. For example, 
you might cast an integer to a float. 


Understanding What Kinds of Data You Can Convert 


Python's data-conversion functions are effective and easy to use, but they work only with suitable data. For 
example, if the variable strQuantity contains the string data "20" — including the double quotes, which 
delimit the string — you can use int (strQuantity) to convert the string "20" to the integer 20. But if 
strQuantity contains "Twenty", using int (strQuantity) returns an error. 


Meet Python’s Functions for Converting Data 

Table 3-1 summarizes the functions that Python provides for converting data from one data type to another. 
You will notice that each function shares the name of the data type to which it converts data. For example, 
the bool () function converts data to the bool data type, the int () function converts data to the int 
data type, and the tuple() function converts data to the tuple data type. 
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Table 3-1 Python's Functions for Converting Data 


Function Converts 

bool () Any data type 

chr () An integer 

complex() A real number and an imaginary number 
dict () Key/value pairs 

float () Any data type 

hex ( An integer 

int ( Any data type 

list () A sequence, collection, or iterator object 
oct ( An integer 

ord ( A character 

set ( A sequence, collection, or iterator object 
str ( Any data type 

tuple () A sequence, collection, or iterator object 


To 

A Boolean value, True or False 
The corresponding ASCII character 
A complex number 

A dictionary 

A float 

A hexadecimal string 

An integer 

A list 

An octal string 

The corresponding ASCII or Unicode code value 
A set 

A string 


A tuple 


Examples of Using Python's Data-Conversion Functions 
Here are brief examples of using Python’s data-conversion functions: 


chr (76) returns L, the ASCII character represented by 76; ord("L") returns 76, the ASCII character 


number. 


bool (1>2) returns False, because 1 is not greater than 2. 


complex (4,7) returns the complex number 4+73. 


dicteSubsects: — (l- UHagtorcyl 2) 
three subjects identified by integer keys. 
int (47.2536) returns the integer 47. 
oct (64) returns 00100, the octal value for 64. 
str(45 + 99) returns a string containing 144. 


tuple(("shoes", "boots", 
footwear. 
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"Geography", 3: 


"Math" } returns a dictionary with 


float(1 + 1.111) returns a float containing 2.111, rounded. 
hex (64000) returns 0xfa00, the hexadecimal value for 64000. 


list (("death", "sickness", "taxes") ) returns a list containing those three cheerless nouns. 
set (myTuple) returns a set containing the unique values from the myTuple collection. 


"waders", "sandals")) returns a tuple containing ill-assorted 
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Working with 
Files and 
Directories 


In this chapter, you learn to use Python to work with files and directories. 
You start by learning the essentials and then move on to navigating between 
directories and working with them. You learn how to return information 
about the user and system and how to split a file path into its components. 
And you gain expertise in opening and closing text files, writing data to 
them, and reading their contents. 
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Understanding Working with Files and Directories 


his section gives you an overview of how you work with files and directories in Python. To 

make sure you are clear on the essentials, we first cover what files and directories are and what 
directory paths and file paths consist of. We then introduce you to three key modules you will need 
to load at different points during this chapter, briefly discuss the basic structure of a file, and give 
you an executive overview of the process of working with text files. 


Understanding What Files and Directories Are 


A file is a named storage unit on a computer. For example, you might create a text file named cats.txt 
that contains textual information about different types of cats. The file has a base name, cats, and a file 
extension, .txt. The file extension typically identifies the type of file; .txt normally indicates a text-only 
file, as in this example. 


A directory, also called a folder, is a special type of file that acts as a container for other files. Python 
commands refer to “directory” rather than “folder,” and this discussion follows suit. If a directory contains 
other directories, that directory is a parent directory, and the directories it contains are subdirectories or 
child directories. 


Most computer operating systems provide each user account with a “home” directory that is kept separate 
from each other user account's directories, such as a C: \Users\Al directory on Windows or a /Users/Ann 
directory on macOS. A user's home directory typically contains various subdirectories, such as a Desktop 
subdirectory and a Pictures subdirectory. 


Understanding Directory Paths and File Paths 


A directory path or folder path gives the location of a directory. For example, if you are the user Ann and 
your home directory on macOS contains a subdirectory called Text, the directory path is /Users/Ann/ 
ARSE 


A file path consists of the directory path to a file plus the filename and file extension. For example, if you 
are still Ann and you store the file cats.txt in the Text subdirectory in your home directory, the file path 
is /Users/Ann/Text/cats.txt. 
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Understanding Three Key Modules for Working with Files and Directories 


For working with files and directories, you will typically need to import one or more of the following Python 
modules: 


© os. The Operating System module, os, includes commands for working with individual files and direc- 
tories. For example, later in this chapter, you use os to create and delete individual directories and to 
return, slice, and dice file paths. 
glob. The Global module, glob, includes commands for searching for file paths that match the pattern 
you specify. For example, in this chapter, you import glob so that you can search using wildcards. 
shutil. The Shell Utility module, shut il, includes commands for taking broad-based actions with files 
and directories. For example, later in this chapter, you use shutil to create multiple directories in a 
single operation — and to remove a whole directory tree, likewise in a single operation. 
To import these modules, you use the import command: 
import os 
import glob 
import shutil 


Understanding a File’s Basic Structure 
A file typically consists of three sections: 


e Header section. This section contains metadata about the file, such as the filename and the file type. 

e Data section. This section contains the file’s actual contents, such as text for a text file or image data 
for a picture. 

e End-of-file marker. The end-of-file marker, or EOF marker, is a special character that denotes the end of 
the file. 


Understanding the Essentials of Working with Files 

To access a file via Python, you open the file by using the open() function. Opening the file does not open 
it in the conventional sense, as you do not see the file’s contents, if there are any; instead, opening the file 
returns a file object that enables you to manipulate the file. 


Once the file is open, you can read its contents; write new data to the file, either preserving or overwriting 
its existing contents; or append new data to the file while preserving its existing contents. 


When you finish working with a file, you use Python’s close() command to close the file. 
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Load the os Module and List Files and Directories 


n this section, you load the os module, which provides methods for working with the file system. 
You use the getcwd() method of the os module to return the current working directory. You 
then use the Listdir() method of the os module to return a list of the files and directories in a 


specified directory. 


You also import the glob module and use its glob() method to return a list of files and directories 
using wildcards. This way enables you to return a targeted list of files and directories. 


Load the os Module 
1 ) Open a terminal window and launch Python. 


@ The Python prompt appears. 


@ Type the following statement, which imports the os 
module, and then press G3. 


import os 
Python loads the os module. 


The Python prompt appears, but there is no other 
acknowledgment that Python has loaded the module. 


List Files and Directories 


1) Type the following statement, which creates a variable 
named current and assigns to it the result of using 
the getcwd() method of the os module. Press GG. 


current = os.getcwd() 


@ Type the following statement, which uses the 
print () command to display the contents of 
current, and then press (ey: 


print (current) 


Python returns the directory, such as 'C: \Users\ 
Guy' on Windows or '/Users/guy' on macOS. 


(3 ) Type the following statement, which creates a variable 
named ££ and assigns to it the result of using the 
listdir() method of the os module to list the files 
in current. Press G@G3. 


ff = os.listdir (current) 
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Command Prompt - python x +v = o x | 


C:\Users\GuyHart-Davis>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:1 
2:15) [MSC v.1929 64 bit (AMD64)] on win32 

Type "help", "copyright", "credits" or "License" for m 


ore information. 
CQ import 2) 
>>> | 


Command Prompt - python x + v = a x 


C:\Users\GuyHart-Davis>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:1 
2:15) [MSC v.1929 64 bit (AMD64)] on win32 

Type "help", "copyright", "credits" or "license" for m 
ore information. 

>>> import os 


>>> current = os.getcwd() 
Ee 2rineCcurrent) 
C: \Users\GuyHart-Davis 


>>> ff = os. lListdir(current) 
>>> | 
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4 ) Type the following statement, which uses the sort () method TB ConmeniPronet-pitton x ED =a 
to sort the contents of ££ in ascending order. Press @NG3. 2/15) [WSC v.1929'64 bit CANDGH)] on wind? 


Type "help", "copyright", "credits" or "License" for m 


ff£.sort ( ) ore information. 
>>> import os 


: ; 7 >>> current = os.getcwd() 
5) Type the following statement, which uses the print () >>> print (current) 
. : €: \Users\GuyHart-Davis 
function to display the contents of ££, and then press (qe: eee) ea 
' int (fF) 

print ( ff ) 5 oan , ‘Application Data', 'Contacts', 'Cookies', 
‘Desktop', ‘Documents', 'Downloads', 'Favorites', ‘Li 
q q a v * nks', ‘Local Settings', ‘Music', 'My Documents', ‘NTUS 
Python displays a list of the directory’s contents. The following ER.DAT', ‘NTUSER. DAT{di25c38d-88du-11ec~a014-00155d003 
: : : 401}.TM.bIf', ‘NTUSER.DAT{d125c38d-88d4-1lec-a014-0015 
example shows an abbreviated version of the list from a 5d003401} . THContainer90909000000900000001. regtrans-ms* 
; , 'NTUSER. DAT{d125c38d-88d4-11ec-a014-00155d003401} .T™M 
Windows PC. Container@9000000000000000002.regtrans-ms', ‘NetHood', 
‘OneDrive', 'OneDrive - First Informed Church', ‘Pict 
['AppData', 'Application Data', ve tséndTot "Start Benu', 'feaplates's "Wideos"s "neu 

'Contacts'! ; 1 Cookies 1 j 'Desktop' ; ser.dat.LOG1', ‘ntuser.dat.LOG2', ‘ntuser.ini'] 


>>> | 


'Documents', 'Downloads!, 'Favorites', 


ies Bi Command Prompt x a Sep 
'ntuser.dat.LOG1', 'ntuser.dat.LOG2', >>> print (current) 

1 ' sy C:\Users\GuyHart-Davis 

ntuser.ini'] >>> ff = os.Listdir(current) 


>>> ff.sort() 


. « % >>> print(ff) 
@ Type the following statement, which imports the glob ['AppData’, ‘Application Data’, ‘Contacts’, ‘Cookies', 
‘Desktop', 'Documents', 'Downloads', 'Favorites', 'Li 
module, and then press Gis. nks', ‘Local Settings', ‘Music', 'My Documents', 'NTUS 


ER.DAT', 'NTUSER.DAT{d125c38d-88d4-11ec-a014-00155d003 
: 401}.TM.bLf', 'NTUSER.DAT{d125c38d-88d4-11ec-a014-0015 
impor ssf g lob 5d003401} . TMContainer00000000000000000001.regtrans-ms' 
, 'NTUSER.DAT{d125c38d-88d4-11ec-a014-00155d003401} .T™M 


@ Type the following statement, which creates the variable £g Manisa; CGreuctia.= Flest meeuraed alien; Pct 
and assigns to it the result of using the glob() method in reget eesalgt en gee arglge Serenmern err 
A a . -dat.LOG1', ‘nt -dat.LOG2', ‘nti -ini'] 
the glob module to search for files and directories whose @ v=: hi: ee ernie 
. : >>> fg = oc 7) 
names begin with D. >>> printfa) 
['Desktop', ‘Doc s', 'Downloads'] 


>>> 


fg = glob.glob("D*") 


6 Type the following print () statement to display the 
contents of fg. Press (Iey9. 


print (fg) 


Python displays the list of items beginning with D, such as 
['Desktop', 'Documents', 'Downloads']. 


TIPS 


How can I determine which operating How can I tell which version of Python is running 

system Python is running on? my code? 

First, type the import sys command, The sys module can tell you the version of Python. Type 

and then press (@{@3, to import the sys import sys, and then press (je, to import the sys module. 


module. Next, type sys.platform, and Next, type sys.version_ info, and then press (ej. Python 
then press (033, to display the value for | returns information such as sys.version_info(major=3, 
the platform: win32 for Windows, minor=10, micro=4, releaselevel='final', 

darwin for macOS, and linux for Linux. | serial=0), which represent Python 3.10.4. 
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Navigate Among Directories 


ython’s os module provides the tools you need to navigate among the directories in the 

computer's file system. You can use the expanduser() method of the path object in the os 
module to return the path to the user’s home directory and then use the chdir() method of the 
os module to switch to that directory. You can use the isfile() method of the os module to 
determine whether a particular directory is present; if it is, you can navigate to the directory and 
then navigate back up from it. 


Navigate Among Directories 


1 ) Open a terminal window and launch Python. mae ee 
|guy@Mac-Pro-2 ~ % python3 15 
@ The Python prompt appears. Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:2 
©) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
(2 } Type the following statement, which imports the Type pen "copyright", "credits" or "license" for mo 
re information. 
os module, and then press Guay. QC p>> import 0s 
|>>> thisdir = os.getcwd() ] 
import os >>> 


© Type the following statement, which creates a 
variable named thisdir and assigns to it the 
result of using the getcwd() method of the os 


module. Press G3. 


thisdir = os.getcwd() 


@ lype the following statement, which uses the 
print () function to display the contents of 
thisdir. Press Ge. 


| 
print (thisdir) 


eee ~ guy — Python — 55x25 
guy@Mac-Pro-2 ~ % python3 LI) 
Python displays the current directory. Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:2 
7 ‘i ©) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
@ Type the following statement, which creates a Type *help", "copyright®, "credies® or license" for wo 
variable named homedir and assigns to it the ie atroreer tai: 
. |>>> import os ] 
result of using the expanduser () method of [>>> thisdir = os.getcwd() 
° * print(thisdir) ] 
the path object in the os module. Press (Te). Msers/quy/Music/Music/Misic 
|>>> homedir = os.path.expanduser ("~") ] 
homedir = os.path.expanduser ("~") |>>> os.chdir(homedir ] 
>> | 
Note: The expanduser () method here takes the 4 


argument ~, which represents the current user's home 
directory. 


6 ) Type the following statement, which uses the 
chdir() method of the os module to change 
directory to homedir. Press G3. 


os.chdir (homedir) 
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@ Type the following statement, which uses the get cwd () ec0e WH suy = Python — 55x25 | 
guy@Mac-Pro-2 ~ % python3 = 
method of the os module, and then press | Enter # Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:2 
©) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
os .getcwd () Type "help", "copyright", "credits" or "license" for mo 


re information. 
>>> import os 


Python displays the current working directory, such as >>> thisdir = os.getewd() 
n >>> print(thisdir) 
'C:\\Users\\Ted' on Windows or '/Users/guy' Vosera/ gy /Muste/Muste/Muste 


on macOS. See the tip for an explanation of the use of \\. —_ [33 Romenat 7, os az) expanduser (i=) 
8 ) Type the following two-line if statement, which uses the et okey ae << 
isdir () method of the path object in the os module wee o8.chdir ("Pictures") 
to determine whether the Pictures directory exists >>> 
in the current directory and changes directory to it if it 
does. Press (@{@%) at the end of each line, and then press 
(2353 again to end the statement. 


if os.path.isdir ("Pictures") : 
os.chdir ("Pictures") 


eee ® guy —-zsh—55x25 
: : = Pros ea% 5 
Note: Indent the second line of the if statement by four Ba tole nc 3 a aaron Waa cen egs 
spaces ©) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
p . Type "help", "copyright", "credits" or "license" for mo 
: . re information. 
9 ) Type the following statement, which uses the >>> import os 
: . >>> thisdir = os.getcwd() 
dirname () method of the path object in the os >>> print (thisdir) 
é /Users/guy/Music/Music/Music 
module to return the parent directory of the current >>> homedir = os.path.expanduser ("=") 
: ; : .chdir (homedi 
working directory, and the chdir() method of the os cep 
y s '/Users/guy' 
module to switch to it. Press [Enter J >>> if os.path.isdir("Pictures"): 
os.chdir("Pictures") 
os.chdir(os.path.dirname (os.getcwd() ) ) ats 
>>> os.chdir(os.path.dirname(os.getcwd())) 
10) Type the following statement to change to the original ii rere eats 


directory, and then press Enter # '/Users/guy/Music/Music/Music' 


>>> 


os.chdir(thisdir) 


@® Press G five times to repeat the os.getcwd () 
statement, and then press Glog. 


os.getcwd () 


Python displays the directory from which you started. 


Why does Python show \\ instead of \ in Windows paths? 
Python uses the backslash, \, as an escape character, a character that modifies the following character 


rather than being executed as itself. Here, \\ represents a single “real” backslash in the path. So the path 
that Python shows as c:\\Users\\Ted is really C: \Users\Ted. You might think of \\ as an escaped 
escape character. 


06_9781119860259-ch04.indd 83 Trim size: 7.375 in x 9.25 in July 8, 2022 2:46 PM 


Create and Delete Directories 


n your code, you will likely need to create directories in which to store files. You may also need to 


delete directories that you no longer require. 


Python’s os module includes the mkdir () function for creating a single directory. The os module 
also provides the makedirs () method, which enables you to create multiple directories at once. 
For example, if you give the command os.makedirs ("/home/sam/Pictures/2022/Dec") from 
the /home/sam directory, which already contains the Pictures directory, Python creates the 2022 


subdirectory and the Dec subdirectory. 


Create and Delete Directories 


Create Directories 
@ Open a terminal window and launch Python. 


@ The Python prompt appears. 


@ Type the following statement, which imports the os module, 
and then press (Se). 


import os 


© Type the following statement, which creates a variable 
named thisdir and assigns to it the result of using the 
getcwd() method of the os module. Press G3. 


thisdir = os.getcwd() 


© Type the following statement, which uses the print () 
function to display the contents of thisdir. 


Press GG. 


print (thisdir) 
Python displays the current directory. 


@ Type the following two-line if statement, which uses the 
isdir() method of the path object in the os module to 
check whether the TYV_ Python directory exists and then 
uses the mkdir () method of the os module to create it if 
it does not. Press (3G) at the end of each line, and press 
(NSB once more to end the if statement. 


if not os.path.isdir("TYV_ Python") : 
os.mkdir("TYV_Python") 


Note: Indent the second line of the if statement by 
four spaces. 
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sam@vubuntu: ~ 1 


isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:04 
[GCC 9.3.0] on linux 
ype "help", “copyright", "credits" or "lice 
information. 
>>> import os 
>>> thisdir = os.getcwd() 
>>> print(thisdir) 


sam@vubuntu: ~ 


lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:04 
[GCC 9.3.0] on linux 
JType "help", "copyright", "credits" or “licen 
information. 

P>> import os 

P>> thisdir = os.getcwd() 

P>> print(thisdir) 

home/sam 

P>> if not os.path.isdir("TYV_Python"): 
os.mkdir("TYV_Python") 


P>> os.chdir("TYV_Python" =<) 
b>> &f 


@ Type the following statement, which 


uses the chdir() method of the 
os module to change to the TYv_ 
Python directory. Press (N09. 


os.chdir ("TYV_Python") 
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@ Type the following statement, which uses the ee 
getcwd() method of the os module to return 


Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


the current working directory, and then press [GCC 9.3.0] on Linux 
Enter } [Type "help", "copyright", "credits" or "License" for more 
© information. 
P>> import os 
os.getcwd () b>> thisdir = os.getcwd() 
>>> print(thisdir) 
7 ] ! /home/sam 
Python displays the directory path, such as ' / ee tee eer ee ripe 
home / sam/TYV_Python WS Le os.mkdir("TYV_Python") 
© Type the following statement, which uses the 7 “Sree ee 
listdir() method of the os module to display (ANSTEY ES 
; . : oe P>> os.listdir() 
a list of the files and directories in the current | 


b>> fj 


working directory. Press (3. 


os.listdir() 


Python displays a list of files and directories 
in brackets. If the directory is empty, as it will 
be if you just created it, Python displays [], 
indicating an empty list. 


sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


Verify visually that the list of files and [GCC 9.3.0] on Linux 
: é a é : Type "help", "copyright", "credits" or "license" for more 
directories does not contain a file or directory information: 


P>> import os 
P>> thisdir = os.getcwd() 
>>> print(thisdir) 


called Examples. 


(10) Type the following statement, which uses the /home/sam 
A Lt He -path.isdir("TYV_Python"): 
mkdir () method of the os module to create a een ies aia 


directory named Examples. Press (ei). Les os .chdir(*TYV Python") 


. >>> os.getcwd() 
os.mkdir ("Examples") */home/sam/TYV_Python' 


P>> os.listdir() 
i Ort 
Python creates the Examples directory but eg ner << 
gives no confirmation that it has done so. b>> 


TIP 


What happens if I try to create a directory that already exists? 
Python throws a FileExistsError error, such as FileExistsError: [Errno 17] File exists: 


'Temp'. You can write code to handle the error, but usually, it is better to use os.path.isdir() to 
check whether a directory exists before trying to create it. 


continued 
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Create and Delete Directories (continued) 


Pythons os module includes the rmdir () method for removing a single file or directory. When 
you need to remove multiple files or directories, you can use the rmdir() method in a loop. 


Sometimes you may need to remove an entire directory tree — a directory and all its 
subdirectories — in a single move. To remove a directory tree, you can import the Shell Utility 


module, shutil, and then use its rmtree() method. 


11) Type the following statement, which uses the 
makedirs() method of the os module to create a 
directory and its subdirectories, and then press Gaou. 


os.makedirs ("Files/Final") 
Python creates the directories but gives no confirmation. 


® Type the following statement, which uses the 
listdir() method of the os module to display the 
directory’s contents, and then press G@uoo. 


os.listdir() 
Python returns the list of files and directories, such as 
['Examples', 'Files']. 


® Type the following statement, which uses the chdir () 
method of the os module to change to the Files directory. 


Press GG. 


os.chdir("Files") 


& Press @ twice to repeat the os. listdir() command, 
and then press (Sey): 


os.listdir() 
Python displays the list of contents of the Files 
directory: ['Final']. 

® Type the following statement to change to the Final 
directory, again pressing 


os.chdir ("Final") 


© Press G9 twice to repeat the os. 1listdir() command, 
and then press (ie): 


os.listdir() 


Python displays the list of contents of the Files 
directory: [] — in other words, nothing. 
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iSam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


"credits" or "license" for more 


P>> if not os.path.isdir("TYV_ Python"): 
os.mkdir("TYV_Python") 


P>> os.chdir("TYV_ Python") 
b>> os.getcwd() 
‘/home/sam/TYV_Python' 

P>> os.listdir() 

0] 


>>> os.mkdir("Examples") 
b>> os.makedirs("Files/Final" 11) 


sam@vubuntu: ~ 


[GCC 9.3.0] on Linux 

ype "help", "copyright", "credits" or "license" for more 

information. 

>>> import os 

b>> thisdir = os.getcwd() 

b>> print(thisdir) 

home/sam 

b>> if not os.path.isdir("TYV_Python"): 
os.mkdir("TYV_Python") 


b>> os.chdir("TYV_Python") 
b>> os.getcwd() 
*/home/sam/TYV_Python' 

b>> os.Llistdir() 

0] 

>>> os.mkdir("Examples") 

b>> os.makedirs("Files/Final") 
b>> os.listdir() 

['Examples', 'Files'] 


>> os.chdir(" 14 


Note: Use os. chdir("..") to move 
up one directory. Add /.. for each 
additional directory level — for example, 
use os.chdir("../../..") to move 
up three levels. 
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@ Type the following statement, which uses the chdir() method with 
the argument ../.. to move up two directories. Press GuGD. 


os Chdir (" oi/s..") 


al |S sam@vubuntu: ~ 


>>> import os 

>>> thisdir = os.getcwd() 

>>> print(thisdir) 

/home/sam 

>>> if not os.path.isdir("TYV_ Python"): 


@ Type the os.getcwd() command again, and then press G@TS3, os.mkdir("TYV_ Python") 


to display the current directory: L3> os.chdir("TYV_Python") 
b>> os.getcwd() 
*/home/sam/TYV_Python' 

>>> os.listdir() 


os.getcwd () 


Python displays the directory path. 


>>> os.mkdir("Examples") 
. ‘ 7 >>> os.makedirs("Files/Final") 
© Type the following statement, which displays the contents of the L>> os. listdir() 
e ‘Examples', 'Files' 

current directory, and then press GG: >> Sane aes 
>>> os. listdir() 
['Final'] 
>>> os.chdir("Final") 
>>> os.listdir() 


os.listdir() 


Python displays the contents of the TYV_ Python directory, t 
! ! ! ; 1 b>: GDOU RC rrciih cic a) 

['Examples', 'Files']. 18 Spa eles <Q 

/home/sam/TYV_Python' 


[>>> 


@ Type the following statement, which uses the rmdir() method to 
remove the Examples directory. Press Guou. 


sam@vubuntu: ~ 


b>> os.chdir("TYV_Python") 
P>> os.getcwd() 
*/home/sam/TYV_Python' 

>>> os.listdir() 

0] 

>>> os.mkdir("Examples") 
>> os.makedirs("Files/Final") 
P>> os. listdir() 
['Examples', 'Files'] 
P>> os.chdir("Files") 
b>> os.listdir() 
['Final'] 

>> os.chdir("Final") 
P>> os. listdir() 

[] 

po> OS wChGtn( 2.0/0.) 
>>> os.getcwd() 
*/home/sam/TYV_Python' 
os.listdir() 
‘Examples', 'Files'] 
b>> os.rmdir("Examples") 


os.rmdir ("Examples") 


@) Type the following statement, which imports the shuti1 module, 
and then press Gicu: 


import shutil 


@ Type the following statement, which uses the rmtree() method 
of shutil to remove the Files directory tree. Press GG). 


shutil.rmtree("Files") 


@) Press © four times to repeat the os. listdir() command, and 
then press Gea: 
os.listdir() 


Python displays the directory’s contents: [] — in other words, 
nothing. 


Why do I need to use shutil.rmtree() to delete a directory tree? 
Python’s os.rmdir() method enables you to delete a directory only if it is empty. If the directory has 
contents, Python returns the error OSError: [Errno 66] Directory not empty. To delete the 


directory using os.rmdir(), you must first remove all its contents. By contrast, the shutil.rmtree () 
method can delete the directory and all its contents. The deletion is immediate and permanent, so use 
xmtree () with great care. 
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Rename, Move, and Copy Files and Directories 


ython’s os module and shutil module provide the commands you need to copy, move, and 

rename files and directories. The rename () method of the os module enables you not only 
to change the name of a file or directory, but also move it to different location by specifying the 
appropriate directory. The remove () method of the os module lets you delete a file, whereas the 
rmdir () method lets you delete a directory that has no contents. 


Rename, Move, and Copy Files and Directories 


1) Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ ype the following statement, which imports the 
os module, and then press (ey). 


import os 


3 ) Type the following statement, which creates the 
variable tdir and assigns to it the path to the 
user’s home directory plus temp1. Press (je). 


tdir = os.path.expanduser("~") + "/ 
temp1" 


Note: See the following section, “Get Information 
About the User and System,” for information about 
the expanduser () method. 


@ Type the following two-line if statement, which 
uses the isdir() method of the path object 
in the os module to check whether the tdir 
directory exists and then uses the mkdir () 
method of the os module to create it if it does 
not. Press (j=) at the end of each line, and 
press (@if@i) once more to end the if statement. 


if not os.path.isdir(tdir): 
os.mkdir (tdir) 


Note: Indent the second line of the if statement by 
four spaces. 


@ Type the following statement, which uses the 
chdir() method of the os module to change to 
the tdir directory. Press GXG9. 


os.chdir(tdir) 


88 


06_9781119860259-ch04.indd 88 Trim size: 7.375 in x 9.25 in 


eco ™ guy — Python — 60x28 

guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more in 
formation. 


>> import os ] 
>>> tdir = os.path.expanduser("~") + "emp" <p J 
>> Ef 


eee ™ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 


[>>> tdir = os.path.expanduser("~") + "/temp1" 
[>>> if not os.path.isdir(tdir) : 
os.mkdir(tdir) 


ee 

Diesers 

[>>> os.chdir(tdir) <A 
>>> Ef 
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eee ~ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

[>>> import os 

[>>> tdir = os.path.expanduser("~") + "/temp1" 

[>>> if not os.path.isdir(tdir): 

far os.mkdir(tdir) 


6 ) Type the following statement, which uses the 
getcwd() method of the os module to return the 
current directory, and then press (je). 


i) 


os.getcwd () 


Python returns the path, such as '/Users/guy/ 
temp1 ', [>>> os.chdir(tdir) 

[>>> os.getcwd() 

'/Users/guy/temp1' 

[>>> f1 = open("myfile.txt", w) <Q 
[>>> f1.close() 

>>> Ef 


@® Type the following statement, which creates the 
variable £1 and assigns to it a text file created in the 
current directory using the open() function. Press 


f1 = open("myfile.txt", "w") 


Type the following statement, which uses the close () 
method to close the £1 file object. Press GG. 


f£1.close() 


eee ~ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

[>>> import os 

[>>> tdir = os.path.expanduser("~") + "/temp1" 

[>>> if not os.path.isdir(tdir): 

Biscecs os.mkdir(tdir) 


9 ) Type the following statement, which uses the os. 
listdir() method to list the directory’s contents, 


and then press (jeu): 


os.listdir() 


Python displays the list, such as ['myfile.txt']. 


[>>> os.chdir(tdir) 

[>>> os.getcwd() 
'/Users/guy/temp1' 

[>>> f1 = open("myfile.txt", "w"') 
[>>> f1.close() 

[>>> os. listdir() 

'myfile.txt'] 


import shutil 
>> shutil.copy("myfile.txt", "copy. txt") RY 


'copy.txt' 
>>> 


€© Type the following statement, which imports the 
shutil module, and then press GG: 


import shutil 


11) Type the following statement, which uses the 
copy () method of the shutil module to copy 
myfile.txt toa file named copy.txt in the 
same directory. Press Ge). 


shutil.copy("myfile.txt", "copy.txt") 


Python returns 'copy.txt', indicating that 
shutil has copied the file. 


TIP 


What is the difference between shutil.copy() and shutil.copyfile()? 
The shutil.copy() method is the standard means of copying a file. It copies the source file to the specified 


destination and preserves the file’s metadata in the copy. The shutil.copyfile() method likewise copies 
the source file to the destination directory, but does not preserve the file’s metadata in the copy. 


continued 
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Rename, Move, and Copy Files and Directories 


(continued) 


here is some overlap between the file- and directory-management capabilities of the os module 
and those of the shut il module, but generally speaking, the shut il module’s commands are 
wider ranging than those of the os module. 


The copy () method of the shutil module lets you create a copy of a file, whereas the copytree () 
method of shut il enables you to copy a directory and all its contents. Similarly, the move () method 
of the shut il module enables you to move an entire directory tree from one directory to another. 


ec5o guy — Python — 60x28 
guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

>>> import os 

>>> tdir = os.path.expanduser("~") + "/temp1" 

>>> if not os.path.isdir(tdir): 

os.mkdir(tdir) 


® Press &) three times to repeat the os. listdir() command, 
and then press (ie): 


os.listdir() 


Python displays the list, such as ['copy.txt', 
'myfile EXE T ] 4 >>> os.chdir(tdir) 
>>> os.getcwd() 
'/Users/guy/temp1' 
>>> f1 = open("myfile.txt", "w") 
>>> fl.close() 
>>> os. listdir() 
['myfile.txt'] 
>>> import shutil 
>>> shutil.copy("myfile.txt", "copy. txt") 
"copy.txt' 
os. listdir() 


['copy.txt', 'myfile.txt'] 
>>> os.rename("copy.txt", "spare.txt") 
>>> os.remove("spare.txt") 


>>> 


® Type the following statement, which uses the rename () 
method of the os module to rename the copy.txt file to 
spare.txt. Press [Enter J 


os.rename ("copy.txt", "spare.txt") 


® Type the following statement, which uses the remove () method 
of the os module to remove spare. txt, and then press Gicu. 


eco guy — Python — 60x28 

lang 12.0.5 (clang-1205.0.22.11)] on darwin e 
Type "help", "copyright", "credits" or "license" for more in 
formation. 

>>> import os 

>>> tdir = os.path.expanduser("~") + "/temp1" 

>>> if not os.path.isdir(tdir): 

F os.mkdir(tdir) 


os.remove ("spare.txt") 


Type the following statement, which uses the mkdir () 
method of the os module to create a subdirectory called 
today in the temp1 directory. Press GIe9. 


>>> os.chdir(tdir) 

>>> os.getcwd() 

'/Users/guy/temp1' 

>>> fl = open("myfile.txt", "w") 

>>> fl.close() 

>>> os.listdir() 

C'myfile.txt'] 

>>> import shutil 

>>> shutil.copy("myfile.txt", "copy.txt") 
"copy.txt! 

>>> os. listdir() 

['copy.txt', 'myfile.txt'] 

>>> os.rename("copy.txt", "spare.txt") 


>>> os.remove("spare. txt") 
>>> os.mkdir ("today") 
os. listdir() 


['today', 'myfile.txt'] 
>>> shutil.copy("myfile.txt", "today") 
"today/myfile.txt! 


>>> 


os.mkdir ("today") 


Press @) four times to repeat the os.1listdir() command, 
and then press (Sei): 


os.listdir() 
Python returns ['today', 'myfile.txt']. 


@ Type the following statement, which uses the copy () method 
of the shutil module to copy myfile.txt to the today 
directory, and then press 3: 


shutil.copy("myfile.txt", "today") 


Python returns 'today/myfile.txt', indicating that 
shutil has copied the file. 
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® Type the following statement, which uses os. 
listdir () to list the contents of the today 


directory. Press G9. 
os.listdir ("today") 


Python returns ['myfile.txt']. 


(19) Type the following statement, which uses the 
copytree() method of the shutil module to 
copy the today directory and its contents to a 
directory named backup. Press @iGy. 


shutil.copytree("today", "backup") 


Python returns 'backup', indicating that 
shutil has created the directory. 


@ Press @9 twice to reenter the os. listdir () 
statement, but change the directory to 
"backup" before you press Gilea: 


os.listdir ("backup") 


Python returns ['myfile.txt'], enabling you 
to see that the copied directory’s contents are 
present. 


How doI move a directory and all its contents? 


CHAPTER 


Working with Files and Directories 


eee ~ guy — Python — 60x28 
Bes os.mkdir(tdir) lel 


[>>> os.chdir(tdir) 

[>>> os.getcwd() 

'/Users/guy/temp1' 

[>>> f1 = open("myfile.txt", "w'') 

[>>> f1.close() 

[>>> os. listdir() 

['myfile.txt'] 

[>>> import shutil 

[>>> shutil.copy("myfile.txt", "copy.txt") 
'copy.txt' 

[>>> os.listdir() 

['copy.txt', 'myfile.txt'] 

[>>> os.rename("copy.txt", "spare.txt") 
[>>> os.remove("spare.txt") 

[>>> os.mkdir ("today") 

[>>> os. listdir() 

['today', 'myfile.txt'] 

[>>> shutil.copy("myfile.txt", "today") 
'today/myfile.txt' 

[>>> os. listdir ("today") 


C'myfile.txt'] 
[>>> shutil.copytree("today", "backup" 19) 
‘backup! 


>> Ef 


eee ~ guy — Python — 60x28 
fisicce os.mkdir(tdir) = 


[>>> os.chdir(tdir) 

[>>> os.getcwd() 

'/Users/guy/temp1' 

[>>> f1 = open("myfile.txt", "w'') 

[>>> f1.close() 

[>>> os. listdir() 

['myfile.txt'] 

[>>> import shutil 

[>>> shutil.copy("myfile.txt", "copy.txt") 
'copy.txt' 

[>>> os. listdir() 

['copy.txt', 'myfile.txt'] 

[>>> os.rename("copy.txt", "spare.txt") 
[>>> os.remove("spare.txt") 

[>>> os.mkdir ("today") 

[>>> os. listdir() 

['today', 'myfile.txt'] 

[>>> shutil.copy("myfile.txt", "today") 
'today/myfile.txt' 

[>>> os. listdir ("today") 

C'myfile.txt'] 

[>>> shutil.copytree("today", "backup") 


‘backup! 
[>>> os. listdi r("backup") G49) 
['myfile.txt'] 


>>> Ef 


To move a directory tree, import the shutil module and use its move () method. For example, to move the 


directory tree files to the directory archive/files, first type import shutil and press @Qe9, and 
then type shutil.move("files", "archive/files") and press (jc). If the directory does not 
exist, the move () method creates it automatically. 
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Get Information About the User and System 


be code may need to return information about the user running or system running a script. For 
example, you might want to determine where a user’s home directory is so that your code can use 
it, return the working directory, or learn the computer's operating system. 


You use different tools to access different types of information. For example, the os module gives 
access to the user's home directory, while the sys module lets you determine the operating system. 
Environment variables offer detailed information about the user and the computing environment on 
Linux and macOS but provide little information on Windows. 


The following subsections explain how to return the user’s name from the getpass module, return 
the user’s home directory from the os module, return the computer's operating system via the sys 
module, and use environment variables to access a wider range of information on Linux and macOS. 


Return the User’s Username 
To return the user’s username, first import the getpass module, and then use the getuser() method: 
import getpass 


username = getpass.getuser () 
print (username) 


Return the User’s Home Directory 


To return the user’s home directory, first import the os module, and then use the expanduser () method 
of the path object in the os module, with the argument ~, as in the second of the following statements. 
The third statement uses the chdir() method to change directory to the homedir directory. 


import os 
homedir = os.path.expanduser ("~") 
os.chdir (homedir) 


Determine the Computer's Operating System 
To determine the computer's operating system, first import the sys module: 


import sys 
You can then return the platform attribute to get the operating system — for example: 
print (sys.platform) 


The value win32 indicates Windows, darwin indicates macOS, and either linux or linux2 indicates 
Linux. 


92 


06_9781119860259-ch04.indd 92 Trim size: 7.375 in x 9.25 in July 8, 2022 2:46 PM 


CHAPTER 


Working with Files and Directories 


Return Information Using Environment Variables 


Python’s environment variables enable you to return a wide range of information about the user and the 
environment on Linux and macOS, but not on Windows. 


Table 4-1 explains the most widely useful environment variables. 
Table 4-1: Python’s Environment Variables 


Variable Name _Returns the Example 
USER User's username jo 


‘LOGNAME User's loginname  =———ss 10a 
HOME User’s home directory on macOS or Linux /Users/jo 


‘LANG Current language encoding en_US.UTF-8 
ODES Old working directory /sers/jo_ 
PWD Current working directory /Users/jo/samples 


SHELL The shell, the command language interpreter /bin/zsh on macOS 
/bin/bash on Linux, 


To access the environment variables, you import the os module and then use the environ object. Here are 
quick examples of returning information from environment variables: 


e Import the os module: 
import os 


Return the username: 
os.environ.get ("USER") 


Return the user’s home directory and change directory to it on macOS or Linux: 
homedir = os.environ.get ("HOME") 

os.chdir (homedir) 

Return the language encoding: 

os.environ.get ("LANG") 


Return the present working directory: 
os.environ.get ("PWD") 


Return the current shell: 
os.environ.get ("SHELL") 
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Split a File Path into Its Components 


ython’s os module enables you to split a file path into its components. By using the split () 
method of the path object in the os module, you can split the path and the filename. And 
by using the splitext () method of the path object, you can split the base filename from the 
extension. For example, starting from the file path Users/Ted/Python/Divisionl.txt, you 
can return the path, /Users/Ted/Python; the base filename, Division1; and the file extension, 
.txt. Using the components, you can then build a different file path — for example, creating the 


name for an output file for a script. 


@ Open a terminal window and launch Python. 


@ The Python prompt appears. 


@ Iype the following statement, which imports the 
os module, and then press (ey): 


import os 


©} Type the following statement, which creates a 
variable named fp and assigns to it a file path in 
macOS format. Press GNG3. 


fp = "/Users/Ted/Python/Divisionl.txt" 


4) Type the following statement, which creates the 
variables d and £ and uses the split () method 
of the path object in the os module to assign 
to them the directory path and the full filename, 
respectively, from fp. Press (@Q. 


d, £ = os.path.split (fp) 


@ Type the following statement, which uses the 
print () function to display the contents of d, 


and then press (G33: 
print (d) 


Python displays /Users/Ted/ Python. 


@ Type the following statement to display the 
contents of £, and then press (3: 


print (f£) 


Python displays Divisionl.txt. 
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ec0e a Se 1 | 
/5| 


guy@Mac-Pro-2 ~ % python3 el 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clan 
g 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more infor 


mation. 
>> import os ] 
>>> fp = */Users/Ted/Python/0ivision). xt" EQ ] 


>>> 


ec0e ™ guy — Python — 63x28 
guy@Mac-Pro-2 ~ % python3 jo 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clan 
g 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more infor 
mation. 


>>> import os 
>>> fp = "/Users/Ted/Python/Division1.txt" 
>>> d, f = os.path.split(fp): 
print(d) 
/Users/Ted/Pyth 
>>> print FQ ] 
Division1.txt 


>> | 
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@ Type the following statement, which creates the 
variables £n and x and assigns to them the results 
of using the splitext () method of the path 
object in the os module to split the filename and 
extension in £. Press (Ne. 


fn, x = os.path.splitext (f) 


© Type the following statement to display the 
contents of £n, and then press (3: 


print (fn) 
Python displays Divisionl. 


© Type the following statement to display the 
contents of x, and then press Gq: 


print (x) 
Python displays .txt. 


€© Type the following statement, which creates a 
variable named output and assigns to it a string 
formed from d, f, /, and the extension .rtf. 


Press GSD. 


output = d+ "/" + fn + ".rtt" 


@) Type the following statement to display the 
contents of output, and then press GN: 


print (output) 


Python displays /Users/Ted/Python/ 
Divisionl.rtf. 


TIP 


What other methods does the os. path object provide? 

Here are four highly useful methods. The basename() method returns the filename and extension from a 
file path — for example, typing os. path. basename ("/Users/jill/a.png") and pressing G@qag 
returns 'a.png'. The dirname () method returns the directory path — for example, os.path. 
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eco © guy — Python — 63x28 
guy@Mac-Pro-2 ~ % python3 3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clan 
g 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more infor 
mation. 

>>> import os 

>>> fp = "/Users/Ted/Python/Division1.txt" 

>>> d, f = os.path.split(fp) 

>>> print(d) 

/Users/Ted/Python 

>>> print(f) ] 


Division1.txt 

>>> fn, x = os.path.sptitert(f) <p ] 
Qe ricco ] 

Division1 
>>> print) <p ] 
otxt 


>>> | 


ec0e guy — Python — 63x28 
guy@Mac-Pro-2 ~ % python3 13 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clan 
g 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more infor 
mation. 

>>> import os i} 
>>> fp = "/Users/Ted/Python/Division1.txt" ] 
>>> d, f = os.path.split(fp) ] 
>>> print(d) i} 
/Users/Ted/Python 

>>> print(f) ] 
Division1.txt 

>>> fn, x = os.path.splitext(f) ] 
>>> print(fn) ] 
Division1 

>>> print(x) ] 


a txt 
>>> output = d+ "/" + fn + a 10) ] 
(11 eeatnereeny ] 
/Users/Ted/Python/Divisionl.rtf 

oom | 


dirname ("/Users/jill/a.png") returns '/Users/jill'. The isabs() method returns True if the 
specified path is absolute, beginning with / on UNIX-based file systems and \ on Windows after a drive 

letter and colon, such as c:\. The normcase() method returns paths unchanged on macOS and Linux but 
on Windows converts paths to lowercase and changes forward slashes to escaped backslashes; for example, 


os.path.normcase ("/Users/Jo/Pictures") returns '\\users\\jo\\pictures' on Windows. 
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Understanding Python’s open() Function 


ython’s open() function enables you to open a file if it exists and to create the file if it does 

not exist. The open () function has various modes that you specify by including the appropriate 
argument when you call the function. For example, you can use open() with the w parameter to 
open a file in Write Mode, which enables you to make changes to the file. Or you can use open () 
with the a parameter to open the file in Append Mode, which lets you append data at the end of the 
file’s existing contents. 


The open () function enables you to open a file in one of six main modes: 


e Write Mode. You use Write Mode to write text to the file. Write Mode deletes the current contents of the 
file and inserts the text at the beginning of the file. Subsequent writes occur at the end of the file unless 
you specify a different position using the seek () method. 

Read Mode. You use Read Mode to read the contents of a file. In Read Mode, you cannot make changes 
to the file’s contents. 

Append Mode. You use Append Mode to append text to a file without deleting its existing contents. By 
default, Python inserts the new text at the end of the file unless you specify a different position. 

Write and Read Mode. You use Write and Read Mode to open a file, deleting any existing contents, so 
you can write to the file and then read its contents. 

Read and Write Mode. You use Read and Write Mode when you need to open a file both for reading text 
from it and for writing text to it. 

Append and Read Mode. You use Append and Read Mode when you want to append data to a file and be 
able to read the file’s contents. 


Table 4-2 explains the modes of the open () function. 


Table 4-2: Modes of Python’s open() Function 


Mode _ Explanation 
Create the file if it does not exist; delete its contents if it does exist. Open the file in Write Mode 
with the pointer at the beginning. 
Open the file in Read Mode with the pointer at the beginning. If the file does not exist, an error 
occurs. 7 7 
Create the file if it does not exist. Open the file in Append Mode with the pointer at the end. 


Create the specified file and then open it with the pointer at the beginning. If the file already 
exists, an error occurs. - ; = : 
Create the file if it does not exist; delete its contents if it does exist. Open the file in Write and 
Read Mode with the pointer at the beginning. 

Open the file in Read and Write Mode with the pointer at the beginning. If the file does not 
exist, an error occurs. 


Create the file if it does not exist. 
Open the file in Append and Read Mode with the pointer at the end. 
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Understanding Python’s Ways of Closing Files 


fter opening or creating a file using the open() function and either reading the file’s contents 

or changing them, your scripts will likely need to close that file. You can either close the file 
explicitly by using the close() method of the file object or have Python close the file automatically 
for you. Python can close a file automatically either at the end of a script or when it runs a command 
that implicitly requires the file to be closed. Generally, it is better to close files explicitly, but you 
should understand how both approaches work. 


The first subsection tells you how to close a file manually using the close() method of the file 
object that references the file. The second subsection explains how you can let Python close files 
implicitly in your code. 


Close a File Manually Using the close() Method 

To close a file explicitly, use the close() method at the appropriate point in your code. For example, the 
first of the following statements creates the variable £6 and uses the open() function to assign to it the 
file new.txt, creating the file if it does not exist. The second statement closes the £6 file object. 


£6 = Open (new tack Us woo) 
£6.close() 


Python does not raise an error if you call the close() method on a file object that you or Python have 
already closed. The file object must exist, but it does not have to be open. This flexibility means that you 
can safely use the close() method to ensure that a file has been closed, even if it turns out to have been 
closed earlier. 


Let Python Close a File Implicitly 

Instead of closing a file explicitly using the close() method, you can let Python close the file for you. 
Python closes a file automatically if you assign the file object currently assigned to the open file to a 
different file, as in the following example for macOS or Linux: 


# open h.txt and assign it to the variable f 
= Open (US ercc/heriy/ ieee ly a wilh) 
write text to f 
-write ("Unblock the writer!") 
open j.txt and assign it to the variable f 
= joint AGperes sea /a) ieee, Uae) 
Py chon Closesmh ext iGO un GeeUpN 


Python also closes a file automatically if you use the open() function to reopen the file using a different 
mode. You do not need to close the file explicitly. 
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Open a File If It Exists; If Not, Create It 


ython’s open() function enables you to open a file in Write Mode, Write and Read Mode, 

Append Mode, or Append and Read Mode if the file exists, and create the file if it does not exist. 
Automatically creating a file is especially useful because you need neither write code to check that 
the file exists before you try to open it nor handle an error if the file does not exist. 


Open a File If It Exists; If Not, Create It 


e Open a terminal window and launch Python. 


@ The Python prompt appears. C:\Users\GuyHart-Davis>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [ 
MSC v.1929 64 bit CAMD64)] on win32 

Type "help", "copyright", "credits" or "license" for more inf 
ormation. 


(2 ) Type the following statement, which imports the 
os module, and then press (ey). 


import os >>> 


3 ) Use the os.chdir() method to change to 
a directory in which you can create a sample 
file. For example, type the following statement, 
and then press (ej, to change to your home 


directory: 
os.chdir(os.path.expanduser ("~") ) 
wi ,W j HEI Command Prompt-python =X | - og xX 
@ Type the following statement, which uses the 
getcwd() method of the os module, to display ; 
: . ‘ C:\Users\GuyHart-Davis>python 
the current directory, confirming you have Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [ 
; ‘ MSC v.1929 64 bit (AMD64)] on win32 
navigated to where you intended. Press Enter } Type "help", "copyright", "credits" or "license" for more inf 
ormation. 
os.getcwd () ee HS Ce 


>>> os.chdir(os.path.expanduser("~")) 
os.getcwd() 


7 'C: 'c:\\Users\\GuyHart-Davis' 
Python returns the directory, such as 'C:\\ Se <Q 
Users\\Ad' on Windows. 


Note: In Windows paths, Python’s escaped backslash, 
\\, represents a single “real” backslash, \. 


© Type the following statement, which uses the 
open() function with no mode specified to try 
to open the file offices.txt in the current 
directory and assign it to the variable olist, and 


then press GG. 


olist = open("offices.txt") 
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© Python returns a FileNotFoundError, because 
the file does not exist. 


6) Press @ once to repeat the command, but 
edit the end to add the appropriate argument 
before you press (jet). In this case, use the w 
argument. 


olist = open("offices.txt", "w") 


Note: Use the w argument for Write Mode, the w+ 
argument for Write and Read Mode, the a argument 
for Append Mode, and the a+ argument for Append 
and Read Mode. 


Python creates the file but gives no indication it 
has done so. 


The file is now open in Write Mode. 


7 ) Type the following statement, which uses the 
write() method to write text to the file, and 


then press GG: 


olist.write("Anchorage, Boston") 


6 Type the following statement, which uses the 
close () method to close the file, and then press 


[Enter § 


olist.close() 


TIP 


CHAPTER 
Working with Files and Directories 


Command Prompt - python x + v 


C:\Users\GuyHart-Davis>python 
Python 3.10.2 (tags/v3.10.2:a58ebec, Jan 17 2022, 14:12:15) [ 
MSC v.1929 64 bit (AMD64)] on win32 
Type "help", "copyright", "credits" or "license" for more inf 
ormation. 
>>> import os 
>>> os.chdir(os.path.expanduser("~")) 
>>> os.getcwd() 
'c:\\Users\\GuyHart-Davis' 
>>> olist = open("offices.txt") 
Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
ileNotFoundError: [Errno 2] No such file or directory: ‘offi 


ces.txt' 
>>> olist = open("offices.txt", GQ 
>>> | 


BH Command Prompt - python x tv 


C:\Users\GuyHart-Davis>python 
Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [ 
MSC v.1929 64 bit (AMD64)] on win32 
Type "help", "copyright", "credits" or "License" for more inf 
ormation. 
>>> import os 
>>> os.chdir(os.path.expanduser("~")) 
>>> os.getcwd() 
'c:\\Users\\GuyHart-Davis' 
>>> olist = open("offices.txt") 
Traceback (most recent call Last): 
File "<stdin>", line 1, in <module> 
FileNotFoundError: [Errno 2] No such file or directory: ‘offi 
ces.txt' 
>>> olist = open("offices.txt", "w") 
>>> olist.write("Anchorage, Boston" gp 
17 
>>> olist.close() 
>>> | 


Why does the open () function sometimes fail even though I specify the w argument? 


The open () function with the w argument, the w+ argument, the a argument, or the a+ argument fails if 
you do not have Write permission for the directory in which Python is trying to create the file. 
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Check an Open File’s Status and Close It 


fter opening a file using the open () function, you can use the resulting file object to 
manipulate the file. The following sections show you how to read a file’s data, replace a file’s 
existing data, and append new data to the existing data. 


In this section, you check the properties of a file object to determine information about it. You use 
the name property to return the filename and then use the closed property to determine whether 
the file object is open or has been closed. You then use the close () method to close the file. 


Check an Open File’s Status and Close It 


1) Open a terminal window and launch Python. 


sam@vubuntu: ~ 


isam@vubuntu:~$ python3 

Python 3.8.10 (default, Mar 15 2022, 12:22:08) 
[GCC 9.4.0] on linux 

ype "help", "copyright", "credits" or "license" for more 
information. 


>>> import os 
b>> os.chdir(os.path.expanduser("~") ~<& 


>>> 


@ The Python prompt appears. 


@ lype the following statement, which imports the 
os module, and then press (Te): 


import os 


3 ) Use the os.chdir() method to change to 
a directory in which you can create a sample 
file. For example, type the following statement, 
and then press (=, to change to your home 
directory: 


os.chdir(os.path.expanduser (“~”) ) 


4 ) Type the following statement, which uses the 
open () function with the w+ mode specified 
to open the existing file new. txt, or create it 
if it does not exist, in the current directory and 


assign it to the variable £1. Press GAS). lsam@vubuntu:~$ python3 

Python 3.8.10 (default, Mar 15 2022, 12:22:08) 
[GCC 9.4.0] on linux 

ype "help", "copyright", "credits" or "license" for more 
information. 

>>> import os 

>>> os.chdir(os.path.expanduser("~") ) 

>>> fl = open("new.txt", "w+") 


sam@vubuntu: ~ 


fl = open(“new.txt”, “w+”) 


5 ) Type the following statement, which returns the 
name property of £1. Press (@Ie9. 


f1.name *new.txt' 


@ Python displays ‘new.txt’. 
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6 } Type the following statement, which returns 
the closed property of £1. Press G@3@3. 


f£1.closed 
@ Python returns False. 


@ Type the following statement, which uses the 
close() method to close £1, and then 


press Ge: 


f1.close() 


Python closes the file without confirmation or 
comment. 


@ Press G twice to repeat the second-to-last 
statement, and then press (qe): 


f1.closed 


@ Python returns True. 


9) Press (4) twice to repeat the now second-to-last 


statement, and then press (G3: 


f£1.close() 


Even though the file was already closed, 
no error occurs. 


How can I check which mode an open file is using? 


isam@vubuntu:~$ python3 


[GCC 9.4.0] on Linux 
ype "help", 
information. 
>>> import os 


>>> fl.name 
‘new. txt’ 
>>> fl. closed <Q 
alse 
>>> f1.close( <i) 
| 


>>> 


isam@vubuntu:~$ python3 
[GCC 9.4.0] on Linux 


information. 
>>> import os 


>>> fl.name 
‘new. txt’ 

>>> f1.closed 
False 


b>>> fl.close() 
b>> f1.closed <p 


Python 3.8.10 (default, Mar 15 2022, 12:22:08) 


"copyright", "credits" or "license" for more 


>>> os.chdir(os.path.expanduser("~")) 
>>> fl = open("new.txt", "w+") 


Python 3.8.10 (default, Mar 15 2022, 12:22:08) 


ype “help", "copyright", "credits" or "license" for more 


>>> os.chdir(os.path.expanduser("~")) 
>>> fl = open("new.txt", "w+") 
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sam@vubuntu: ~ 


sam@vubuntu: ~ Q = — i) 


Return the mode property of the file object that represents the file. For example, use £1 .mode to return 


the mode property of the file object represented by £1. The property returns the same string as you use to 
specify the mode with the open () function — for example, w+, r, or a+. 
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Write Data to a File 


o write data to a text file, you open that file in Write Mode by using the open() function with 
the w argument. To write data and subsequently read it, you use the open() function with the 
w+ argument to open the file in Write and Read Mode. 


Both modes create the specified file if it does not exist; if it does exist, both modes “truncate” the 
file, deleting all its contents. Both modes position the pointer at the start of the file, so text you 
add using the write() method lands there. 


Write Data to a File 


@ Open a terminal window and launch Python. 


ec50e © guy — Python — 1) 
i) 


guy@Mac-Pro-2 ~ % python3 eI 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 


>> import os ] 
>>> os.chdir(os.pa vexpanduser(*-") ] 
>>> wl = open("waters.txt", "w''). ] 


>>> | 


© The Python prompt appears. 


(2 } Type the following statement, which imports the os 
module, and then press G3. 


import os 


3 ) Use the os.chdir() method to change to a 
directory in which you can create a file. For example, 
type the following statement, and then press G3, 
to change to your home directory: 


os.chdir(os.path.expanduser ("~") ) 


@ Type the following statement, which creates a variable 
named w1 and assigns to it the file waters.txt, 
which it opens in Write Mode. Press (QE). 


wl = open("waters.txt", "w") guy@Mac-Pro-2 ~ % python3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) rom 


lang 12.0.5 Sa AL 1205.0.22.11)] on darwin 


eee ~ guy — Python — 60x28 


- 7 4 ws : . Type "help", "copyright", "credits" or "License" for more in 
Note: If the file exists, Python “truncates” it, deleting its ee | 
é ‘ ‘ ie - import os 
contents; if not, Python creates it. Either way, the file is >>> os. chdir (os. path. expanduser("~")) 
>>> wl = open("waters.txt", "w" ] 
empty once opened. >>> wl.write("beck, billabong, ee 5) ] 
22 
>>> wl = open("waters.txt", i 6) ] 
5 Type the following statement, which uses the write () >> El 


method to write text to the w1 file object. Press G@iC3. 
wl.write("beck, billabong, bight") 


6 ) Type the following statement, which uses the open () 
function with the xr argument to reopen the text file in 
Read Mode, reassigning it to wi. Press Gieu. 


wl = open("waters.txt", "r") 


Note: Python automatically closes the file before 
reopening it. 
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eee ~™ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

|>>> import os 

[>>> os.chdir(os.path.expanduser ("~")) 

|>>> wl = open("waters.txt", "w"') 

|>>> wl.write("beck, billabong, bight") 


@ Type the following statement, which uses the 
print () function to display the output from using 
the read () method on w1. Press GG. 


print (wl.read() ) 


Python displays beck, billabong, bight. 


>>> wl = open("waters.txt", "r") 
print(wl.read()) 


eck, billabong, bight 
[>>> wl = open("waters.txt", oo 8 | 
>>> 


6 Type the following statement, which uses the 
open () function with the w+ argument to 
reopen the text file in Write and Read Mode, again 
assigning it to wl. Press G3. 


wl = open("waters.txt", "wt") 


Note: Again, Python automatically closes the file before 
reopening it. Python truncates the file, deleting its contents. 


© Type the following statement, which writes two 
fresh waters to the file, and then press (9. 


eee ~ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

[>>> import os 

[>>> os.chdir(os.path.expanduser ("~") ) 

[>>> wl = open("waters.txt", "w"') 

|>>> wl.write("beck, billabong, bight") 


wl.write("kill, tarn") 


€© Type the following statement, which reads the file 
from the pointer position. Press G3. 


wl1.read() 


Python displays '', an empty string, because the 
pointer is at the end of the file. 


|>>> wl = open("waters.txt", "r'") 
[>>> print(w1.read()) 

beck, billabong, bight 

|>>> wl = open("waters.txt", "wt") 


[>>> wl.write("kill, tarn") 
10 

[>>> wl. read) <Q) 

tw 


@®) Type the following statement, which uses the 
seek () method to move the pointer to the file’s 
beginning, and then press (ye: 


wl.seek(0, os.SEEK_ SET) 


@ Press @ twice to repeat the wi . read () 
statement, and then press qe): 


wli.read() 


Python displays 'kill, tarn', the contents 
you wrote. 


How can I see whether a file is open? 
Check the closed property of the appropriate file object. For example, if your code has created a file 


object named w1, as in the main example, w1.closed returns False if the file object is open and True if 
it has been closed. 
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Open a File for Both Reading and Writing 


o open a file for both reading and writing, use the open() function with the r+ argument. 

Because the file is open for writing as well as reading, you will need to be careful to avoid 
overwriting the existing contents of the file. For example, you can use the seek () method to move 
the pointer to the end of the file before writing new data to the file using the write () method. 
After writing, you can move the pointer back to the beginning of the file to read all its contents 
using the read() method. 


Open a File for Both Reading and Writing 


@ Open a terminal window and launch Python. 


eo0e ™ guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) tc 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

>>> import os 

|>>> os.chdir(os.path.expanduser ("~") ) 

[>>> rwf = open("metals.txt", "w'') 

>>> 


@ The Python prompt appears. 


(2 } Type the following statement, which imports the 
os module, and then press (yey). 


import os 


3 ) Use the os.chdir() method to change to a 
directory in which you can create a file. For 
example, type the following statement, and then 
press (Sty, to change to your home directory: 


os.chdir(os.path.expanduser ("~") ) 


@ Type the following statement, which creates a 
variable named rw and assigns to it the file 
metals.txt, which it opens or creates in Write 


Mode. Press GC). 


rwf = open("metals.txt", "w") eco guy — Python — 60x28 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) Ic 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

|>>> import os 

|>>> os.chdir(os.path.expanduser ("~")) 


[>>> rwf = open("metals.txt", "w'') 
[>>> rwf. write("Calcium\ncattiun\n") <p 


16 
[>>> rwf = open("metals.txt", a 6) 
>> Ef 


@ Type the following statement, which uses the 
write() method to write text to the rwf file 
object, and then press GNG9. 


rwf.write ("Calcium\nGallium\n") 


Python returns 16, the character position at the 
end of the file. 


6 ) Type the following statement, which opens the 
same file in Read/Write Mode and assigns it to 


rw again. Press (je. 


rwf = open("metals.txt", "r+") 


Note: Opening the file with the r+ argument causes 
Python to close the file and then reopen it. 
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@ Type the following statement, which uses the 
seek () method to move the pointer to the end 
of the file, and then press (3: 


rwf.seek(0, os.SEEK_ END) 


eee ~ guy — Python — 60x28 
|guy@Mac-Pro-2 ~ % python3 = 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

|>>> import os 

[>>> os.chdir(os.path.expanduser ("~") ) 

[>>> rwf = open("metals.txt", "w") 

[>>> rwf.write("Calcium\nGallium\n") 


|>>> rwf = open("metals.txt", "r 
[>>> rwf.seek(0, os.SEEK_END) 


16 
[>>> rwf.write("Cesium" << 
6 


>>> rwf.seek(0, os.SEEK_ o 


Python returns 16, the character position at the 
end of the file. 


6 Type the following statement, which uses the 
write () method to add text to the file, and 


then press GG3: 


rwf .write ("Cesium") 
Python returns 6, the number of characters added. 


© Type the following statement, which uses the 
seek () method to move the pointer to the start 


of the file, and then press (TG): 
eee ~ guy — Python — 60x28 

rwf.seek(0, os.SEEK_ SET) PUN EHACEPTSTa = a Gy tRone 7 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 

lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 

formation. 

|>>> import os 

[>>> os.chdir(os.path.expanduser ("~") ) 

|>>> rwf = open("metals.txt", "w") 

[>>> rwf.write("Calcium\nGallium\n") 


Python returns 0, the character position at the start 
of the file. 


€© Type the following statement, which uses the 
print () function to display the result of reading 
the file’s contents. Press GS. 


print (rwf.read() ) 


|>>> rwf = open("metals.txt", "r+") 
[>>> rwf.seek(0, os.SEEK_END) 


>>> rwf.write("Cesium") 
Python displays this: 


[>>> rwf.seek(0, os.SEEK_SET) 


[>>> print(rwf.read()) 


Calcium Calcium 
Gallium Gallium 
Cesium 


11) Type the following statement, which uses the close () 
method to close rwf, and then press (je): 


rwf.close() 


How can I tell whether a file is readable or writable? 
Use the readable () method of the file object to determine whether a file is readable — for example, 
myfile.readable() returns True if the file is readable and False if it is not readable. Similarly, you 


can use the writable() method to determine whether a file is writable via the write() method and the 
seekable() method to determine whether Python can use the seek () method to change the pointer 
position within the file. 
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Append Data to a File 


ython provides two modes for appending data to the existing contents of a file without affecting 

the existing contents. Append Mode, which you invoke by using the a argument with the open () 
function, lets you add text after the file’s existing contents. Append and Read Mode, which you invoke 
by using the a+ argument, likewise lets you append text but also lets you read the existing contents. 


Both Append Mode and Append and Read Mode automatically create the specified file if it does not 


exist. Both modes prevent you from modifying the file’s existing contents. 


Append Data to a File 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ Type the following statement, which imports 
the os module, and then press (Qe. 


import os 


3) Use the os. chdir() method to change to a 
directory in which you can create a file. For 
example, type the following statement, and then 
press (2103, to change to your home directory: 


os.chdir(os.path.expanduser ("~") ) 


4 ) Type the following statement, which creates 
a variable named s and assigns to it the file 
staples.txt, which it opens or creates in 
Append Mode. Press (e339. 


s = open("staples.txt", "a") 


© ype the following statement, which uses the 
write() method to append some text to the 
s file object. Press Ge. 


s.write("Staple Foods\n\nCoffee\nEggs") 


Python returns 25, the number of characters added. 


@ Iype the following statement, which uses the 
close () method to close the s file object 
explicitly, and then press (S39: 


s.close() 
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information. 
Qe import 2) 
P>> os.chdir(os.path.expanduser("~") 


me sam@vubuntu: ~ 1 L = = 


isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 


Type "help", "copyright", "credits" or "license" for more 


>>> s = open("staples.txt", "a") 
b>> fj 


sam@vubuntu: ~ 


sam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 

ype "help", “copyright", 
information. 

>>> import os 

b>> os.chdir(os.path.expanduser("~") ) 

>>> s = open("staples.txt", "a") 

ag s.write("Staple Foods\n\nCof fee\nEggs" ) 


P>> s.close( <Q 
b>> ff 


"credits" or "License" for more 
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@ Type the following statement, which opens 
the same file in Append and Read Mode, again 
assigning it to the variable s. Press G@iG9. 


s = open("staples.txt", "at") 


8 ) Type the following statement, which uses the 
write() method to append text to the end of 


the file. Press GS. 


s.write("\nBread\nButter") 


9 ) Type the following statement, which uses the 
seek () method to move the pointer to the start 
of the file. Press EE. 


s.seek(0, OS.SEEK SET) 


(10) Type the following statement, which uses the 
print () function to display the result of using 
the read () method to read the file’s contents. 


Press GS. 


print (s.read() ) 
Python displays the file’s text: 
Staple Foods 


Coffee 


Eggs 
Bread 
Butter 


@® Type the following statement, which uses the 
close () method to close the file, and then press 


s.close() 
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sam@vubuntu: ~ 


am@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 
ype "help", "copyright", "credits" or "license" for more 
information. 
import os 
os.chdir(os.path.expanduser("~")) 
Ss = open("staples.txt", "a") 
s.write("Staple Foods\n\nCoffee\nEggs") 


s.close() 
s = open("staples.txt", at" <@ 
s.write("\nBread\nButter") 


s.seek(0, os. seek set) <<) 


sam@vubuntu: ~ 


sam@vubuntu:~$ python3 


Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 
ype "help", "copyright", "credits" or "license" for more 
information. 
import os 
os.chdir(os.path.expanduser("~")) 
= open("staples.txt", "a") 
-write("Staple Foods\n\nCoffee\nEggs") 


-close() 
= open("staples.txt", "“at+") 
.write("\nBread\nButter") 


.seek(0, os.SEEK SET) 


What happens if I move the pointer and then append text? 
Python appends the text after the end of the existing text. In Append and Read Mode, moving the pointer 


to the start of the file enables you to read the file’s contents, but Python puts any text you append at the 
end of the file. 
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Read a Text File 


ython’s open() function enables you to open a text file in Read Mode by using the r+ argument 

or in Read and Write Mode by using the r+ argument. Usually, the choice between Read Mode 
and Read and Write Mode is straightforward: Use Read Mode when you need only to read the file’s 
contents, but use Read and Write Mode when you also need to change the contents. 


Both modes place the pointer at the start of the file, ready to read from there on. Both modes return 
a FileNotFoundError if the specified file does not exist. 


Read a Text File 


@ Open a terminal window and launch Python. : a 
lsam@vubuntu:~$ python3 
@ The Python prompt appears. Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux ; 
@ lype the following statement, which imports the os es ete Oe at een tee or altering 
module, and then press G3. A 


import os 


3 ) Use the os.chdir() method to change to a directory 
in which you can create a file. For example, type the 
following statement, and then press (G3, to change to 
your home directory: 


os.chdir(os.path.expanduser ("~") ) 


@ lype the following statement, which creates a variable 
named xr and assigns to it the file waters.txt, which it 


Isam@vubuntu:~$ python3 


opens or creates in Write Mode. Press (339. Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 
xr = open("waters.txt", "w") \Type "help", "copyright", "credits" or "license 
information. 
‘ F import 
5.) Type the following statement, which uses the write () So oe chilir(od pat Wexpanauger(®=")}) 
is >>> xr = open("waters.txt", "w") 
method to add text to xr, and then press (ey: ee gree ean eae) 
18 
xr.write("sound, swamp, wadi") SSSerotopen(suarenstixt to 6) 
>>> REIS SD 
6 ) Type the following statement, which reopens the same file 
in Read Mode. Press (3. 
xr = open("waters.txt", "r") 


Note: Python automatically closes the text file before 
reopening it. 


@ Type the following statement, which uses the print () 
function to display the result of using the read () 
method to read the contents of xr. Press GG}. 


print (xr.read() ) 
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Python displays sound, swamp, wadi. Ale EonNnee 1 


isam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 

ype "help", "copyright", "credits" or "license" fd 
information. 

import os 
os.chdir(os.path.expanduser("~") ) 
xr = open("waters.txt", "w") 
xr.write("sound, swamp, wadi") 


6 Type the following statement, which uses the close () 
method to close xr explicitly. Press GQG3. 


xr.close() 


Type the following statement, which opens the file in 
Read and Write Mode, again assigning it to xr. Press 


Enter J 


xr = open("waters.txt", "r+") 


xr = open("waters.txt", "r") 
print(xr.read()) 
ound, swamp, wadi 


xr.close() 
P>> xr = open("waters.txt", +) <Q 


>>> print(xr.read()) 
isound, swamp, wadi 
>>> xr.write(", Lagoon") 


Press |) three times to repeat the print () statement, 
and then press (2vei): 


print (xr.read() ) 


Python displays sound, swamp, wadi again. 


Type the following statement, which writes another term 
to the file, and then press (@ieiy: m > sam@vubuntu:~ 16 - 


sam@vubuntu:~$ python3 

xr.write(", lagoon") Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 

JType "help", "copyright", "credits" or "license" fq 


Press |) twice to repeat the print () statement, and information. 
é , P>> import os 
E en press Ga: P>> os.chdir(os.path.expanduser("~")) 
P>> xr = open("waters.txt", "w") 
print (xr.read() ) P>> xr.write("sound, swamp, wadi") 
18 
: = “waters.txt", "r" 
@ Python returns a blank paragraph, because the Write eee a en 
. = u sound, swamp, wadi 
operation has moved the pointer to the end of the file. Reemeeerere 
: . P>> xr = open("waters.txt", "r+") 
@®) Type the following statement, which uses the seek () pee print (xr.read()) 
. . sound, swamp, wadi 
method to move the pointer to the start of the file. b>> xr.write(", lagoon") 
8 
Press Gr. P>> print(xr.read()) 
xr.seek(0, os.SEEK SET) G p>> xr.seek(0, os SEEK SET) <0) 
= 10 
& Press @ twice to repeat the print () command, and been cer \ccae Gate 
then press (NC: = 


print (xr.read()) 


Python displays sound, swamp, wadi, lagoon, 
the file’s entire contents. 


TIP 


What happens if I move the pointer to the start of the file and then write text? 


If you explicitly move the pointer to the start of the file, the text you write overwrites any text that is in 
the way. If the text you write is shorter than the existing text, some of the existing text remains. 
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CHAPTER 5 


Working 
with Python’s 
Operators 


Python provides a wide range of operators for performing operations on 
values and variables. You use arithmetic operators to perform mathematics, 
assignment operators to assign data to variables, comparison operators to 
make comparisons, and logical operators to link conditional statements. 
You use identity operators to test whether objects are identical, 
membership operators to determine whether an object includes a particular 
value, and bitwise operators to compare and manipulate binary numbers. 
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Meet the Arithmetic Operators 


hen you need to perform arithmetical operations in Python, such as addition or division, you 

can use standard arithmetic operators, adapted slightly for the computer keyboard. For example, 
while the keyboard includes the + key for addition, it has no + key for division, so you use () for 
division instead. 


Python performs operations following the standard order used in mathematics. This order is 
sometimes summarized by the acronym PEMDAS: Parentheses, Exponentiation, Multiplication, 
Division, Addition, and Subtraction. You can change the order of operations by putting particular 
operations in parentheses, thus promoting them to earlier positions in the order of operations. 


Table 5-1 explains the arithmetic operators you can use in Python. Most of these are instantly 
recognizable, with the possible exception of these two: 


e Integer division. Also called floor division, this operation returns only the integer component of 
the result. For example, with regular division, 10 divided by 4 returns 2.5. With integer division, 
10 divided by 4 returns 2, discarding the decimal component and returning the integer. 

¢ Modulus. This operation returns the remainder — the number left over — from a division opera- 
tion. For example, 5 modulus 4 returns 1, because 1 is the remainder after dividing 5 by 4. Simi- 
larly, 9 modulus 4 also returns 1, and 399 modulus 200 returns 199. 


Table 5-1: Python's Arithmetic Operators 


Operation Operator Example Returns 
Addition + 1 +1 2 
Subtraction - 2-1 1 
Multiplication * 3 .* 3 9 
Exponentiation * 2**8 256 
Division / 3°73 1.0 
Integer Division // 9 // 4 2 
Modulus % 10 % 3 1 
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Understanding the Order of Operations 
Python implements mathematical operations in the standard order given by the acronym PEMDAS: 


1. Parentheses 

2. Exponentiation 

3. Multiplication and Division 
4. Addition and Subtraction 


When two operations at the same level occur, Python evaluates them reading from left to right. 
So take for example the following calculation: 

4** 3-5 %* 8+ 4 / (1 + 1) 

This calculation returns 26. Python evaluates it as follows: 


e Parentheses: (1 + 1) gives 2, so the calculation becomes 
4**3-5%* 8+ 4/2 


Exponentiation: 4 ** 3 gives 64. The calculation becomes 
64-5 * 8+ 4/2 


Multiplication: 5 * 8 gives 40. The calculation becomes 
64-40 + 4/2 


Division: 4 / 2 gives 2. The calculation becomes 
64 - 40 + 2 


Addition and subtraction: 64 - 40 occurs first, giving 24. Then 24 + 2 gives 26. 


Changing the Order of Operations 

You can change the order of operations in a calculation by placing one or more parts of the calculation in 
parentheses. For example, say you want to add 5 and 5, giving 10, and then multiply that by 10. This gives 
100, but if you use the following calculation, you get 55 instead because of the standard order of operations: 


i: ap ey alo) 


To change the order of operations, you put the addition component inside parentheses, making Python 
evaluate it first: 


(5 ap 5) = al@ 


You can nest parentheses within parentheses, as needed. Python performs the most deeply nested 
calculation first — for example: 


(SB se ((2 = 8) = aly) = alo 


Here, Python multiplies 2 by 3, subtracts 1 from the resulting 6, adds the resulting 5 to the first 5, and 
multiplies the resulting 10 by 10, giving 100 again. 
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Work with the Arithmetic Operators 


n the previous section, 


“Meet the Arithmetic Operators,” you learned what arithmetic operators 


Python provides and what they do. In this section, you put the arithmetic operators to work 


performing calculations. 


To work through these examples and those later in this chapter, open a terminal window on your 
computer. For example, on Windows, click Search (f@)), type cmd, and then click Command Prompt 


(MM) or press @XG9. On macOS, click Launchpad ( ::: 


), and then click Terminal (@§). On Ubuntu, click 


Show Applications (AB), and then click Terminal (i). 


Work with the Arithmetic Operators 


Launch Python and Perform Arithmetic 
Calculations 


@ Open a terminal window and launch Python. 
© The Python prompt appears. 


@ lype the following addition calculation using 
the + operator, and then press Gey. 


5 +4 
Python displays the result, 9. 


©} ype the following subtraction calculation, 
and then press Gey. 
4-7 
Python displays the result, -3. 


@ Type the following multiplication calculation, 
and then press (jeu). 
6.33% 9.2 


Python displays the result, 58.236. 


© Type the following exponentiation calculation, 
and then press Gucw. 
2 ** 8 
Python displays the result, 256. 


6 } Type the following division calculation, 
and then press Guu. 
77 / 12 


Python displays the result, 7.0. 
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[BE Command Prompt - python - o x 


River's serorecee | 
hon 3.10.0 teags/v3. cee 0:b494f59, Oct 4 2021, 19:00:18) [MSC v.192 
Y64 bit CAMD64) J on win 


‘ype "help", “copyright”, a ncradits” or "license" for more information. 


[BH Command Prompt - python - o x 


j wears \guyeyenon | 

on 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) [MSC v.192 
Ya bit CAMD64) J on win32 
e 


"help", “copyright", "credits" or "license" for more information. 


@ Type the following integer division calculation, 
and then press Gnu. 


90 // 11 


Python displays the result, 8. 
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Note: Integer division returns only the integer __ [ii command Prompt = python =o x 
component of the result of the division : \Users\guy>python | 
4 - a " ython 3.10.0 (tags/v3.10.0:b494fF59, Oct 4 2021, 19:00:18) [MSC v.192 
calculation, discarding the remainder. E 64 bit (AMD64)] on win320 7 . : 
ype "help", “copyright", "credits" or "license" for more information. 
© Type the following modulus calculation, and > 5 + 4 
then press GG. x EAA 
; Fé. 286. * 9.2 
90 % 11 > 2 ** 8 
Python displays the result, 2. pd 
>> 90 // 11 
Note: The modulus gives the amount left over s> 90 % lL 
following a division operation. In this case, 11 > 
times 8 produces 88, so the modulus gives 2. 
Using Parentheses to Change the Order 
of Precedence 
In the terminal window, type the following TEl Command Prompt ex 
calculation, and then press (fey. Nicene \gaysoyeion 


| 
srg! EI tN ak Oct 4 2021, 19:00:18) [MSc v.192 
64 bit_ (AMD on win 
5 +4 * 8 / 2+ 1 ype "help", “copyright", "credits" or "license" for more information. 


Python displays the result, 22.0. 


@ Iype the calculation again, this time 
adding parentheses around 5 + 4, 


and then press (ie). 

(5 + 4) * 8/241 

Python display the result of the adjusted 
calculation, 37.0. 


© Jype the calculation a third time, this 
time adding parentheses around 2 + 1, 


and then press (no. 


(5 + 4) * 8 / (2 + 1) 


Python displays the new result, 24.0. 


TIP 


Why does division return a floating-point number with .o rather than an integer? 
Using the division operator, /, always produces a floating-point number, even if the calculation results in 


an integer with a .0 decimal component. 
If necessary, you can use the int () function to convert a floating-point number to an integer. 
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Meet the Assignment Operators 


A: you have seen earlier in this book, Python uses the equal sign, =, to assign a value to a 
variable. For example, you can use the statement userLevel = "Professional" to create a 
variable called userLevel and assign the string value Professional to it. 


Python includes a dozen other assignment operators. These operators are for assigning a value to a variable 
by manipulating its existing value. For example, the += assignment operator adds to a variable’s existing 
value: myInt += 7 has the same effect as myInt = myInt + 7 but is quicker and easier to enter. 


Table 5-2 explains the assignment operators, showing a brief example of each and giving the 
equivalent full command. 


Table 5-2: Python’s Assignment Operators 


Operation Operator Example Equivalent 
Assignment Operator 

Assignment only = strl = "Manager" Not applicable 
Arithmetic and Assignment Operators 

Addition and assignment += x += 1 x=x +1 
Subtraction and assignment -= x -= 2 x =x - 2 
Multiplication and assignment *= x *= 3 x =x * 3 
Division and assignment /= x /= 4 x= x/A4 
Percentage and assignment S= x $= 6 xX = xX % 6 
Floor division and assignment //= x //= 7 x =x // 7 
Exponentiation and assignment k= x **= 8 x = x ** 8 
Bitwise and Assignment Operators 

In-place AND and assignment &= a &=b az=aé&b 
In-place OR and assignment = a |= b az=al|b 
In-place XOR and assignment “= a “=b az=a*b 
Bitwise right shift and assignment >>= KX >>= 2 X =X >> 2 
Bitwise left shift and assignment <<= x <<= 3 X= xX << 3 


The first of the assignment operators, =, needs no introduction, as you have already used it 
extensively to assign values to variables. Beyond this, you will recognize the arithmetic-plus- 
assignment operators from the earlier section, “Meet the Arithmetic Operators.” For example, the 
+ operator performs addition, and the += operator performs addition and assignment. 


The five assignment operators that include bitwise operations — «=, |=, *=, >>=, and <<= — 
evaluate and manipulate the bit values in binary numbers and then perform assignment. See the 
section “Meet the Bitwise Operators,” later in this chapter, to learn the details of bitwise operations. 
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Work with the Assignment Operators 


L the previous section, “Meet the Assignment Operators,” you learned about the assignment 
operators Python provides and what they do. In this section, you use two of the arithmetic-and- 
assignment operators to manipulate the existing values of variables and then reassign the result 
back to the same variables. See the section “Meet the Bitwise Operators,” later in this chapter, for 
examples of working with Python’s bitwise operators. 


Work with the Assignment Operators 


ay Open a terminal window and launch 
Python. 


© The Python prompt appears. 


2) Type the following statement, which 
creates the variable myNum and 
assigns the value 2 to it, and then 


press GaGp. 
myNum = 2 

©} Type the following statement, which 
gets the value in myNum, adds 1, and 


then reassigns the resulting value to 
myNum. 


myNum += 1 


@ lype the following statement, and 
then press (yey, to display the value 
of myNum. 


print (myNum) 
Python displays the value of myNum, 3. 


© Type the following statement, which 
uses the exponentiation and assignment 
operator, and then press (e9. 


myNum **= 3 


@ Type the following statement, and then 
press (@1@%3, to display the value of 
myNum again. 


print (myNum) 


Python displays the value of myNum, 27. 
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eee ™ guy — Python — 59x22 

lguy@Mac-Pro-7 ~ % python3 ] 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [ 
Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more i 
nformation. 


>>> myNum = 2<Z) ] 
al 


myNum += ] 


>> print (myNum 
3 
>> fj 


eee @ guy — -zsh — 59x22 

lguy@Mac-Pro-7 ~ % python3 } 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [ 
Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more i 
nformation. 


[>>> myNum += 1 ] 


117 


July 1, 2022 2:39 PM 


Meet the Comparison Operators 


hen you need to compare values in your code, you use Python’s comparison operators. The 

comparison operators enable you to determine whether two values are equal or not equal; 
whether one value is greater than or less than another value; and whether one value is greater than 
or equal to, or less than or equal to, another value. 


Table 5-3 explains the comparison operators. Chances are that you will be familiar with most of these 
from math class. 


Table 5-3: Python’s Comparison Operators 


Comparison Operator Example Returns 
Equal to == 1 == True 
Not equal to I= 7 l= 7 False 
Greater than > 5 >3 True 
Less than < 5 <3 False 
Greater than or equal to >= 7 >= 7 True 
Less than or equal to <= 7 <= 6 False 


The exception is the equal-to operator, ==, which uses two equal signs because Python uses a single 
equal sign, =, as the assignment operator for assigning value to variables. This operator checks 
whether the two values are mathematically equal but not whether they are the same item. If you 
need to check whether two items are the same, use the is operator for the comparison; see the 
section “Meet the Identity Operators,” later in this chapter. 


Each comparison operator returns the Boolean value True if the comparison is true and the Boolean 
value False if the comparison is not true. 


Examples of Using Comparison Operators 
Here are examples of using comparison operators with two variables: a = 1 andb = 2: 


== b returns False. 
!= b returns True. 
> b returns False. 
< b returns True. 
>= b returns False. 


<= b returns True. 
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CHAPTER 


Work with the Comparison Operators 


L the previous section, “Meet the Comparison Operators,” you learned about the comparison 
operators Python provides and how they work. In this section, you try the comparison operators. 
You start with integer values that make it easy to verify that you are getting the results you expect, 
move on to comparing strings, and then compare a binary value with a decimal value. 


Work with the Comparison Operators 


@ Open a terminal window and launch [it coroner hon ea -o x] 
Python. 


| 
ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18 


[Msc v.1929 64 bit (CAMD6 4)] on win32 
@ The Python prompt appeals: ype "help", "copyright", “credits" or "license" for more 


fF 
@ Iype the following statement, which uses Qe n=? 2~<€> 


P ors \guy>python 


the == operator, and then press (@@9. pp>_2/3 != 4/6 
alse 
== 2%* 2 P>> 


Python returns True, because the result 
of multiplying 2 by 2 is 4. 


© ype the following statement, which uses 
the != operator, and then press (Set). 
2/3 i= afé 


Python returns False, because the two 
operands have the same value. 


@ Type the following statement, which uses the > _ [iat conmanaone = oo 81 
operator, and then press GG). ee eo | 
ython 3.10.0 (tags/v3.10.0:b494fF59, Oct 4 2021, 19:00:18 
"expenses" > "expense" D [MSC v.1929 64 bit CAMD64) J on win32 
[Type “help", "copyright", “credits” or "license" for more 
: information. 
Python returns True, because the string >> 4==2%2 
‘ rue 
expenses evaluates to greater than the string >>> 2/3 != 4/6 
False 
expense. >> "expenses" > "expense"@@Q 
e ue 


r 
5) Type the following statement, which uses the =o 


>= operator, and then press Gye. 
0b100000 >= 32 


pP>> 


Python returns True, because the binary value 
100000 is equal to the decimal value 32. 
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Meet the Logical Operators 


ython provides three logical operators that enable you to make logical comparisons in your code. 

The and operator returns True if both the operands evaluate as True. The or operator returns 
True if one or both operands evaluate as True. The not operator reverses the Boolean value of the 
operand, changing the value True to False and the value False to True. 


Table 5-4 lists Python’s logical operators. 


Table 5-4: Python’s Logical Operators 


Comparison Operator Explanation 
AND and Returns True if each statement tested is True; otherwise returns False. 


OR or Returns True if one or more of the statements tested is True; returns False if none 
of the statements is True. 


NOT not Returns False if the statement tested is True; returns True if the statement 
tested is False. 


Understanding How the Logical 
Operators Work 


The first figure shows how the and operator 
works. If the first statement is False, the and 
operator returns False without evaluating the 
second statement; but if the first statement is 
True, the and operator evaluates the second 
statement, returning True if it is True and 
False if it is False. 


‘ Output x AND y = False x AND y = True 
The second figure shows how the or operator | Output 
works. If the first statement is True, the or 


operator returns True without evaluating the 
second statement; but if the first statement is 
False, the or operator evaluates the second 
statement, returning True if it is True and 
False if it is False. 


nae 


x OR y =True| x ORy = False | x OR y =True 
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CHAPTER 
Work with the Logical Operators 5 


n the previous section, “Meet the Logical Operators,” you learned about the logical operators 
Python provides — and, or, and not — and the operations they perform. In this section, you 
practice using these operators with straightforward examples. 


To work through these examples, open a terminal window on your computer. As you work, remember 
that Python requires initial capitalization on the terms True and False. Any other capitalization, 
from TRUE to true, produces a NameError error saying that the name is not defined. Similarly, you 
must use lowercase for and, or, and not. 


Work with the Logical Operators 


a Open a terminal window and launch 
Python. 


iB Command Prompt - python - o x 


= \Users \guy apy tha | 
ython 3.10.0 teags/v3. 10.0:b494f59, Oct 4 2021, 19:00:18) [MSc v.192 
64 bit CAMD64)] on win32 

ype “help", "copyright", “credits” or "license" for more information. 


© The Python prompt appears. 


@ lype the following statement, which 
uses the and operator, and then 


press (Te. 


True and True 


>> True and True 


rue 
>> True and False 
‘als 


>> 


Python returns True, because both statements 
are True. 


©} Type the following and statement, and then 
press (2033. 


True and False 


BE Command Prompt 


= Ausers Ney Py Chon | 
ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) [MSC v.192 
64 bit CAMD64)] on win32 

‘ype "help", “copyright", “credits” or "license" for more information. 


Python returns False, because only one 
statement is True. 


>> True and True 


rue 
>> True and False 


@ Type the following or statement, and 188 oe true 
then press GS. 
True or True 


Python returns True, because at least one 
statement is True. 


© ype the following or statement, 
and then press (Sei). 


True or False 


6] Type the following not statement, and then 
Again, Python returns True, press Gp. 


because one statement is True. nee Wane 


Python returns False. 
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Meet the Identity Operators 


ython provides two identity operators that you can use to compare the identity of objects. 

Comparing identity means checking that the two objects are actually the same object, in the 
same memory location. This is different from checking that the objects are equal, which means they 
have the same value. Two objects can be equal without being the same object. 


You use the is operator to check that objects have the same identity, and you use the is not 
operator to check that objects have different identities. 


Table 5-5 explains the identity operators. 


Table 5-5: Python's Identity Operators 


Identity Operator Example Returns 
The first operand is the same object as is iteml is True if the objects are the same object, 
the second operand. item2 False if they are different objects 


The first operand is not the same object is not iteml is True if the objects are not the same object, 
as the second operand. not item2 False if they are the same object 


Understanding the Identity Operators 


Python stores each distinct object at a separate memory location. The is operator and the is not operator 
use the memory locations to determine whether two objects are the same object or different objects. 


For example, the first of the following statements creates the variable item1 and assigns the value 7 to it. 
The second statement creates the variable item2 and assigns to it the value contained in item1. This 
assignment makes the two objects the same. The third statement uses the is operator to compare item1 
and item2. Because the objects are the same, this statement returns True. 


item1 
item2 = iteml 
iteml is item2 


Another way to determine whether two objects are the same is to see whether they have the same memory 
location. You can use the id() function to display the memory location at which an object is stored. 
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CHAPTER 


Work with the Identity Operators 


ie the previous section, “Meet the Identity Operators,” you learned about Python’s two identity 
operators, is and is not, and what checking identity entails. In this section, you try using 


these operators. You also use the id() 


function to return the memory location of two objects, 


another way of determining whether the objects are the same. 


Work with the Identity Operators 


‘a Open a terminal window and launch Python. 
© The Python prompt appears. 


@ Type the following statement, which creates 
the variable item1 and assigns it the value 7, 


and then press jet. 
iteml = 7 
© Type the following statement, which creates 


the variable item2 and assigns it the value 
of item1, and then press GS. 


item2 = iteml 


@ Type the following statement, which uses the 
is operator to compare the objects, and then 


press Gey. 


iteml is item2 


Python returns True, because the objects are 
the same. 


© Type the following statement, which uses the 
) function to return the memory location of 
item1, and then press (ey. 


id(item1) 


Python displays the memory location, such as 
1743901755952. 


@© Type the following statement, which returns the 


memory location of item2, and then press (3. 


id(item2) 
Python displays the memory location. 


You can see it matches the location for item1. 
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sh bg ep 
hon 3.10.0 ttags/v3. 10.0:b494f59, Oct 4 2021, 19:00:18) 
ruse ve 1929 64 bit CAMD64) J on win32 
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ormation. y 2) 
>> iteml = 7 


>> item2 = rs 3 
>> iteml is it 


em. 
rue 
>> 


BH Command Prompt 


chy ribig taal 

ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 
[Msc v.1929 64 bit CAMD64) J on win32 

ype oo » "copyright", "credits" or "license" for more in 
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Meet the Membership Operators 


ython’s membership operators give you a way to test whether a value appears in a particular 
sequence or iterable object. For example, if you have a list of machine parts, you can use the 
membership operators to determine whether the list includes a particular part number. 


The in operator returns True if the sequence is included in the object and returns False if it 
is not. The not in operator works the other way around, returning True if the sequence is not 
included in the object and returning False if it is. 


Table 5-6 explains Python’s two membership operators. 


Table 5-6: Python’s Membership Operators 


Membership Operator Example Returns 
The item is included in the selection. in "dog" in ["cat", "dog"] True 
The item is not included in the selection. not in "cat" not in ["cat", "dog"] False 


Understanding the Membership Operators 


You can use the membership operators with any of Python’s sequence objects or iterable objects: dictionary, 
list, set, string, and tuple. 


For example, the first statement in the following code creates a list named partNumbers and assigns three 
alphanumeric strings to it. The second statement tests whether the string A104 appears in the list. 


partNumbers = ["A104", "A105", "A106"] 
"A104" in partNumbers 


This example returns True. 


Similarly, the following statement tests whether the string Boxing appears in a classic pangram string: 


"Boxing" in "The five boxing wizards jump quickly." 


This example returns False, because Boxing has an initial capital, whereas boxing does not. 
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CHAPTER 


Work with the Membership Operators 5 


[’ the previous section, “Meet the Membership Operators,” you learned about Python’s two 
membership operators, in and not in. In this section, you explore some quick examples using 
these operators to check whether a specific value is present in a list and whether a substring is 
included in a string. 


Work with the Membership Operators 


a) Open a terminal window and launch Python. 


BH Command Prompt - python 


:\Users\guy>python 
ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 


© The Python prompt appears. 


@ Type the following statement, which creates ao 
the variable myList and assigns to it a short 11-—<@Q 
list of integers, and then press (NU). 


myList = [1, 3, 5, 7, 11] 
© Type the following statement, which creates 


the variable myPrime and assigns the value 7 
to it, and then press (9. 


myPrime = 7 


@ Type the following statement, which tests 
whether myPrime is in myList, and then 


press Gaep. 


fH Command Prompt - oF x 
myPrime in myList :\Users\guy>python 
fees gees Chae (et ee wate Oct 4 2021, 19:00:18) 
MSC v. it CAMD on win 
Python returns True. ype "help", "copyright", hcoden* or "license" for more in 


© ‘ype the following statement, which tests whether 35 myerine =-7" 7797 7" 44) 


8 is in myList, and then press t 
Y P Enter ] 8 in myList 
‘ : ‘alse 
8 in myList >> myString = "North, South, west“ 
= "East" in mserino~egD 
aise 
Python returns False. >> 


@ Type the following statement, which creates the 
variable myString and assigns a string, and then 


press Gap. 


myString = "North, South, West" 


@ Type the following statement, which tests 
whether East appears in myString, and then 


press (GD. 


"Fast" in myString 


Python returns False. 
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Meet the Bitwise Operators 


ython includes six bitwise operators for performing Boolean logic on individual bits. The first 

three bitwise operators — AND, OR, and XOR — are for making comparisons between bits. The 
fourth bitwise operator, NOT, inverts the value of each bit. The last two bitwise operators enable you 
to shift the bits in the binary number either to the left, by adding zeros to the end of the number 
and discarding the equivalent number of bits from the start; or to the right, by adding copies of the 
leftmost bit to the start and discarding the equivalent number of bits from the end. 


Table 5-7 explains Python’s bitwise operators. 


Table 5-7: Python's Bitwise Operators 


Operation Operator Explanation Example Returns 
Bitwise & Returns 1 if each bit has the value 1; otherwise, 1&1 1 
AND returns 0. 0&1 ) 
Bitwise | Returns 1 if either or both bits have the value 1; otherwise, 1 | 1 1 
OR returns 0. 1 | 0 1 

0 | 0 0) 
Bitwise ~* Returns 1 if only one bit has the value 1; otherwise, returns 0 * 1 1 
XOR 0. 1* 1 0) 
Bitwise = ~ Inverts the value of each bit. ~1lé1 0 
NOT ~0&0 

~1lé&0%71 
Zero-fill << Shifts the binary digits left, adding zeros to the right end and 1 << 16 65536 
left shift discarding the equivalent number of bits from the left end. 
Signed >> Shifts the binary digits right, adding copies of the leftmost 65536 >> 8 256 
right shift bit at the left end and discarding the equivalent number of 


bits from the right end. 


Understanding the Bitwise Operators Table 5-8: Python’s Bitwise Operators 


Python's: bitwise operators enable you to use Boolean logic Input 1 Input 2 Bitwise) Bitwise Bitwise 
on individual bits and to perform bit-shifting, moving the AND OR XOR 
digits in a binary number to the left or right. . ° ‘ 


Table 5-8 shows the output of the bitwise AND, OR, and 
XOR operators. The difference between the bitwise OR 


0 il i 
operator and the bitwise xor operator is that XOR c : i 
performs an exclusive OR operation, so it returns 1 only if 1 i 0) 
its two inputs differ from each other. By contrast, the 

bitwise oR returns 1 if each input evaluates to 1 as well as if only one input evaluates to 1. 


Earlier in this chapter, you met three assignment operators that include bitwise operations: *=, >>=, and 
<<=. These operators work in the same way as the bitwise-only &, >>, and << operators, except that they 
also reassign the resulting value to the operand. 
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CHAPTER 


Work with the Bitwise Operators 


ie the previous section, “Meet the Bitwise Operators,” you learned about Python’s six bitwise 
operators. In this section, you use these operators to manipulate individual bits. You start by 
performing bitwise AND, OR, and XOR operations; you then use the bitwise NOT operator to invert bit 
values; and you finally use the zero-fill left shift operator and the signed right shift operator to shift 


binary digits to the left and to the right. 


Work with the Bitwise Operators 


@ Open a terminal window and launch Python. 
© The Python prompt appears. 


@ Type the following statement, which uses the 
bitwise AND operator, and then press (ety. 


1&1 


Python returns 1, because each bit has the value 1. 


© Type the following statement, which uses the 
bitwise oR operator, and then press qc. 


1/1 
Python returns 1, the result of the nonexclusive OR 
comparison. 


@ Type the following statement, which uses the 
bitwise XOR operator, and then press (je). 


1* 1 
Python returns 0, the result of the exclusive OR 
comparison. 


© Type the following statement, which uses the 
bitwise NOT operator, and then press G@uco. 


~1 
Python returns -2, the result of inverting the bit. 


6 Type the following statement, which uses the 
zero-fill left shift operator, and then press Guco: 


1 << 8 


Python returns 256, which is binary 
100000000 — 1 shifted left by 8 places, which 
are then filled with zeros. 


Trim size: 7.375 in x 9.25 in 


eco ™ guy — Python — 56x23 
guy@Mac-Pro-7 ~ % python3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20 


5 


) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "license" for mor 


e informatio: 
>» 1& 2) ] 
ab 
3 ee | 
1 
>>> 1A <Q 


eco @ guy — -zsh — 56x23 

guy@Mac-Pro-7 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20 
) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for mor 
e information. 

>>> 1k1l 


@ Type the following statement, which uses the 
signed right shift operator, and then press (ica: 


256 >> 8 


Python returns 1, the result of shifting binary 
100000000 right by eight places, placing a 
copy of the leftmost bit at the left end. 
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CHAPTER 6 


Making 
Decisions with 
if Statements 


Python includes all the tools you need to make decisions easily and 
effectively in your code. In this chapter, you meet Python’s if statements, 
if... else statements, and if... elif statements and put them to work 
in your code. You also learn how to nest if statements to make complex 


decisions in your scripts. 


If x > 10: 
print ("x is greater than 10.") 


is less than 5.") 
elif x == 5: 
print ("x equals 5.") 
else: 
print ("x is more than 5 but less than 11.") 


Evaluate if 
condition 
x > 10 


A Spent Block | Evaluate first 
prin "x is greater we 
: elif condition 
than 10.") xz5 


Execute first elif block 
“print ("x is less” Evaluate 
than 5.") second elif 
condition 
xee5 


Execute else block 


Execute second elif block print ("x is more than 
print ("x equals 5.") 5 but less than 11.") 


ecution continues 
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Learn the Essentials of if Statements 


i ik make decisions in your code, you use Python’s various types of if statements. When an if 
statement’s condition evaluates to True, Python runs the code that follows the statement. An 
if... else statement runs the if code when the condition is True and the else code when it 
is False. An if... elif statement can evaluate not only the if condition but also one or more 
elif conditions, as needed; you can add an else statement that runs code when both if and all 
elif conditions evaluate to False. You can nest if statements to make complex decisions. 


Essential Features of if 
Statements 


The three main forms of if statement are 
plain if, if... else, andif... 
elif. The if statement looks like this, 
with italics indicating placeholders: 


if expressioni: 
code bilocks Zl 


The if... else statement looks like 
this and is illustrated nearby: 


if expressioni: 
code block 1 
else: 
code block 2 


The if... elif statement looks like 
this: 


if expression: 
GoOdew bil OGiaae 

elif expression2: 
code block 3 
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TE x 2210: 

print ("x is greater than 10.") 
else: 

print ("x is 10 or less.") 


I 


Evaluate if 
condition 
x > 20 


Execute if block Execute else block 


print ("x is print 
greater than 10.") 


Code execution continues 


("x ie 10 or 
less.") 
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CHAPTER 


Making Decisions with if Statements 


The following list explains the components of these if statements: 
e The if keyword introduces the if statement. 


e expression1 and expression2 are expressions that evaluate to a Boolean True value or a Boolean 
False value. For example, if x = 10: evaluates to True if x equals 10 but evaluates to False if x 
evaluates to anything other than 10. 


A colon (:) follows expression1 or expression2. This colon is required; Python throws a 
SyntaxError: expected ':' error if you omit the colon. 


Similarly, a colon (:) follows the else statement. This colon is required. 


code block 1 is an indented block containing one or more statements that Python executes after the 
if condition evaluates to True. 


code block 2 is an indented block containing one or more statements that Python executes after the 
if condition evaluates to False. 


code block 3 is an indented block containing one or more statements that Python executes after the 
elif statement evaluates to True. 


Each code block must be indented; if not, Python returns an IndentationError error, such as 
expected an indented block after 'if' statement. Visual Studio Code and other editors can 
automatically apply the required indentation for you. 


The end of the indentation marks the end of the code block attached to the if statement. Execution 
resumes at the next line that does not have the indentation. 


You may want to leave a blank line after the end of an if block to make your code easier to read, but 
there is no need to do so. 
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Understanding the if Statement 


hen your code needs to make a straightforward decision between taking an action and not 


taking an action, you can use an if statement. For example, your code might check the value of 


a variable to see whether it is 100 or more. If the value is indeed 100 or more, the code would take 
action by running the if code block; if the value is less than 100, the code would take no action. 


How the if Statement Works 


An if statement begins with the if keyword followed by the expression to be evaluated for the condition. 
The statement ends with a colon. If the expression evaluates to True, the statements in the code block run. 


if expression: 
code block 


For example, the following if statement checks 
whether the value of the variable x is greater than 
10. If so, the print () statement runs. The 
illustration represents the flow of execution. 


aie BE > IOs 
print ("x is greater than 10.") 


When an if statement’s code block contains only 
a single statement, you can place that statement 
on the same line of code as the if statement. For 
example, the following if statement’s code block 
has only a single statement: 


if ampm < 12: 
print ("Good morning!") 


Instead, you can place the code block on the same 
line: 


if ampm < 12: print("Good morning!") 
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Code execution continues 


July 1, 2022 9:23 PM 


Create an if Statement 


CHAPTER 


| eed a al if statement enables you to test a condition and take action if that condition 
evaluates to True. For example, your code may need to evaluate input provided by the user and 
take action if the input is of a certain type. If the condition evaluates to False, the code takes no 
action. Execution continues at the line of code after the end of the if statement. 


Create an if Statement 


In Visual Studio Code, create a new script, and 
then save it. 


2) Type the following statement, which creates a 
variable named x and assigns to it the string 
resulting from prompting the user to enter a 
number between 1 and 20. Press (Te). 


x = input ("Enter a number between 


1 and 20 (inclusive): ") 


©) Type the following statement, which converts the 
string x to an integer and assigns the result back 


to x. Press ep. 


x = int (x) 


@ ype the following if statement, which tests 
whether x is greater than 10. Press (ey). 


Le x > 10% 


@ Visual Studio Code automatically indents the next 
line for you to enter the code block. 


(5) Type the following statement, which uses the 
print () function to display a message, and then 


press Geo. 


print ("x is greater than 10.") 
@ Click Run Python File in Terminal ([>). 
The Terminal pane appears. 
7 ) Type a number greater than 10 and press (ey). 


@ Python displays the message x is greater 
than 10. 


® if_statement 3 x Dy 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if_statement >. 
1 x = input("Enter a number between 1 and 20 (inclusive): i 2) 
x = int(x) 


ei . 
, 1 


Python 3.10.0 64-bit CodeTogether @3A0 Ln4,ColS Spaces:4 UTF-8 LF Python @ QO 


eco if_statement 
® if_statement x 6 a 8) 
Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if_statement 
1 x = input("Enter a number between 1 and 20 (inclusive): ") ““ 
2 x = int(x) 
3 if x>10 4 
4 print("x is greater than 0." 
6 
PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE + _ AX 
guy@Mac-Pro-2 ~ % /usr/local/bin/python3 /Users/guy/Drgpbox/TYV_Python/Code/Asso >)zsh 
rted/if_statement 
Enter a number between 1 and 20 (inclusive): 7) 2} Python 
x is greater than 10. 


guy@Mac-Pro-2 ~ % 


UTF-8 


Python 3.10.0 64-bit CodeTogether @0A\ Ln5,Col5 Spaces: 4 


LF Python # QO | 


6 Click Run Python File in Terminal ([>) again, but this time type a number less than 11, and then press 
(NSB. This time, the condition evaluates to False, so the code block does not run, and Python does not 


display the message. 
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Understanding the if... else Statement 


hen your code needs to decide between two paths of action, use anif... else statement. 

The if line contains an expression that evaluates to a Boolean True or a Boolean False. 
If the expression evaluates to True, Python runs the statements in the code block that follows 
the if line. After this code block comes the else line, followed by the code block containing the 
statements for Python to run if the expression evaluates to False. 


How the if...else Statement Teer e 


Works print ("x is greater than 10.") 
: ; else: 
An if... else statement begins with print ("x is 10 or less.") 


the if keyword followed by the 


expression to be evaluated for the 

condition. The statement ends with a 

colon. If the expression evaluates to 

True, the statements in the if code Seer 
block run. If the statement evaluates to “condition 
False, execution moves to the else Bieta 
line, and the statements in the else 


code block run. Execute if block Execute else block 
print("x is print("x is 10 or 
if expression: greater than 10.") less.") 
code block 1 
else: 


code block 2 


Continuing the previous example, the 

following if statement checks whether 

the value of the variable x is greater 

than 10. If so, the if code block runs, Code execution continues 

and the print () statement displays a 

message that x is greater than 10; if not, the else statement’s code block runs, making its print () 
statement display a message that x is 10 or less. The nearby illustration shows the flow of execution. 


ae 32 Ss L@s 

print ("x is greater than 10.") 
else: 

jonealiate, (Wore alfe} al0) yone lreyeiss,. ¥) 
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Create aniff... 


Wis ss 


CHAPTER 


else Statement 


else statement enables you to test a condition and take one of two courses of action 


depending on the result. If the condition evaluates to True, Python runs the statements in the 
code block that follows the if line; if the condition evaluates to False, Python runs the statements 


in the code block that follows the else line. 


® In Visual Studio Code, create a new script, and 
then save it. 


Type the following statement, and then press 
(@3S3. This statement creates a variable named x, 
prompts the user to enter a number, converts the 
input string to an integer, and assigns it to x. 


x = int (input ("Enter a number between 
1 and 20 (inclusive): ")) 


© Type the if condition, the colon, and the 
print () statement, as before. Press G33. 


LE x > 10: 
print("x is greater than 10.") 


@ Press to remove the indent, type the 
else statement and its colon, and then press 


else: 


@ Visual Studio Code applies an indent after the 
else: line. 


5 ) Type the following print () statement, and 
then press Gucw. 


print ("x is 10 or less.") 
@ Click Run Python File in Terminal ([>). 
The Terminal pane appears. 
@ Type a number less than 11, and then press Qe). 


@ Python displays the message from the else 
block. 


|, Python 3.10.0 64-bit CodeTogether @0 A 


|, Python 3.10.0 64-bit CodeTogether © 0A 


@ if_statement 


1 | 


® if else statement x 
Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if else statement > ... 
1 x = int(input("Enter a number between 1 and 20 tinctusive =< 
7 ")) 


2 if x > 10: 
3 | print("x is greater than 10." << 
4 


D~O- 


Ln4,Col5 Spaces:4 UTF-8 LF Python # O | 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if else statement > ... 


1 x = int(input("Enter a number between 1 and 20 (inclusive) == 
: ")) 

2 if x> 10: 

3 print("x is greater than 10.") 


else: 
print("x is 10 or ess." 


OUTPUT TERMINAL DEBUG CONSOLE 


guy@ac-Pro-2 ~ % /usr/local/bin/python3 "/Users/guy/Dropbox/TYV_Python/Code/Ass 
orted/if else statement" 

Enter a number between 1 and 20 (inclusive): 7 

x is 10 or less. 


guy@ac-Pro-2 ~ % ff 


if else statement 


® if_statement ® if else statement x 


PROBLEMS: 


Ln6,Col5 Spaces:4 UTF-8 LF Python & 


6 Click Run Python File in Terminal ([>) again. This time, type a number 11 or greater, and then press GNC. 


Python displays the message from the if block. 
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Understanding the if... elif Statement 


hen your code needs to evaluate two or more conditions, use anif... elif statement. 

After the if line (which as usual contains an expression that evaluates to a Boolean True or 
a Boolean False) and the if code block, the if... elif statement has one or more elif lines, 
each of which contains another expression to evaluate. After the if expression evaluates to False, 
Python evaluates the first elif expression, running its code block if it evaluates to True or moving 
along to the next elif line if it evaluates to False. 


How the if... elif If x > 10: 
Statement Works print ("x 1s greater than 10-") 


Gulalie see Bie 
The if... elif statement udbale (Tes Mey Mei) leas 2 2) 


consists of an if line with an i 


expression to evaluate, ending in 

a colon; a code block to execute 

if the expression evaluates to 

True; an elif line, likewise with Evaluate if 

an expression and ending ina sea 

colon; and a code block to 

evaluate if the elif expression ae 

evaluates to True. Here is a Sere as Evaluate elit 


pseudocode representation: greater than 10.") ence 


if expression1: 
code block 1 Execute elif block 
a 4 if print("x is less 
elif expression?2: eee) 
code block 2 


Here is an example, also 
illustrated nearby: 


ie 36 5 aLO)s 

print("x is greater 
than 10k) 
Gulaue oe = 52 

print("x is less 
thangs) 


Code execution continues 


You can add as many elif statements as you need to test more than two conditions. You can also add an 
else statement after the last elif statement, making anif... elif... else statement. See the 
section “Understanding the if... elif... else Statement,” later in this chapter, for an example. 
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CHAPTER 


Create anif... elif Statement 


nif... elif... statement enables you to test multiple conditions, taking different actions 

depending on which condition evaluates to True and taking no action if each condition 
evaluates to False. As usual, the if line is followed by its code block; similarly, each e1if line is 
followed by its code block. 


You can use multiple elif lines to test more conditions. You must arrange the elif lines in the 
appropriate order for testing, because once a condition evaluates to True, Python executes the 
following code block and does not test any further conditions. 


if_then_elif statement 


In Visual Studio Code, create a new script, and 
then save it. 


if_statement if else statement ® if_then_elif statement 3 x Dy 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if_then_elif statement > ... 
x = int(input("Enter a number between 1 and 20 (inclusive) “"~ 


@ Copy and paste — or simply retype — the first 2") 


three lines from the if... else example you 
created in the previous section: 


if x > 10: 
print("x is greater than 10." << 


elif x < 


x = int (input ("Enter a number between 
1 and 20 (inclusive): ")) 
if x > 10: 


print("x is greater than 10.") 


© Press GHZ to create a new line, press 
to delete the indent, and type the 
following elif line. Press (SQ again. 


elif x < 5: 


Python 3.10.0 64-bit CodeTogether @ 3 A Ln§,Col5 Spaces:4 UTF-8 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if_then_elif statement oe 
1 x = int(input("Enter a number between 1 and 20 (inclusive) =" 


4 ) Type the following statement, which uses the 2") 
print () function to display a message about aaa a 
the value of x, and then press GG. 


LF Python # O | 


if_then_elif statement 


@ Visual Studio Code automatically indents the next 
line following the elif line and its colon. 


if_statement 


if else statement ® if_then_elif statement 


2 

3 

4 elif x <5: 

5 |  print("x is less than "<Q 
6 


OUTPUT TERMINAL DEBUG CONSOLE 


print ("x is less than 5.") 


© Click Run Python File in Terminal ([>). 


PROBLEMS, 


/usr/loca\/bin/python3 "/Users/guy/Dropbox/TYV_Python/Code/Assorted/if_then_elif 3} zsh 
atement" 


guy@Mac-Pro-2 ~ % /usr/local/bin/python3 “/Users/guy/Deopbox/TYV_Python/Code/Ass B) Python 
orted/if_then_elif statement” 


Enter a number between 1 and 20 (inclusive): 4 
is less than 5. 
guy@ac-Pro-2 ~ % 


The Terminal pane appears. 


6 } Type a number less than 5 and press (TS). 
@ Python displays the message x is less than 5. 


|, Python 3.10.0 64-bit CodeTogether @ 0A 


Ln6,Col5 Spaces:4 UTF-8 LF Python # O | 
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Understanding the if... elif... else 
Statement 


nif... elif... else statement combines the features of the if... elif statement and 

the if... else statement. First, you specify the if condition and the code to run if it evaluates 
to True; second, you specify one or more elif conditions, each with the code to run if it is True; 
and third, you specify the code to run if both the if statement and each elif statement evaluates to 
False. You can include as many elif lines as required for all the conditions you need to test. 


How the if... elif... If x > 10: 


print ("x is greater than 10.") 


else Statement Works elif x < 5: 


print ("x is less than 5.") 
elif x == 5: 


The if... elif... else ene reine (ts emuale 5.") 
statement consists of an ce line print ("x is more than 5 but less than 11.") 
with an expression to evaluate, 
ending in a colon; a code block 
to execute if the expression Evalatene 
condi 

evaluates to True; one or ers 
more elif lines, each with 

. _ 6 Execute if block Evaluates: 
an expression, ending in a colon, en sivecondiian 
and followed by a code block to a 
evaluate if that elif expression ExGaitaiiieeols eres 

: print ("x HB less Evaluate 

evaluates to True; the else line, meena seuend ot 
also ending in a colon; and the nine 
code block to execute in the Sera ee pes ceuteelse book 
else case. Here is a pseudocode 


PELE Es CRECUE B1) 5 but less than 11.") 
representation: 


if expression1: 

code block 1 
elif expression2: 

code block 2 
{other elif statements] 
else: 

code block 3 


Code execution continues 


Here is an example, which is illustrated nearby, that uses two elif lines: 


ae 32 S39 ALOs 
print ("x is greater than 10.") 
Glass Se << BS 
joneuliahe, (Woe alfep aleysis} feletewal 5), )) 
GULae Se SS 
jonealiahe (Mex yeibleulisy 5.44) 
else: 
print (x as imere than 5 but desis than ii.) 
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Create an if... elif... 


6Li£.. 0% 


CHAPTER 


else Statement 


else statement enables you to test multiple conditions, taking appropriate 


WME ws 
| ee if any condition evaluates to True and taking other action if all the conditions evaluate 
to False. The statement begins with an if line and expression, followed by a code block. Similarly, 
each elif line contains an expression and is followed by its code block. Finally, the else line 
appears, without an expression but followed by its code block. 


You can include multiple elif lines to test multiple conditions. 


1) In Visual Studio Code, create a new script, and then save it. 


(2 } Copy and paste — or retype, if you prefer — the first 
five lines from the if... else example you created 
in the previous section: 


x = int (input ("Enter a number between 
1 and 20 (inclusive): ")) 
if x > 10: 

print("x is greater than 10.") 
elif x < 5: 

print("x is less than 5.") 


© Press GIG) to create a new line, press to 


remove the indent, and then type the following elif 
line. Press (S39 again. 


elif x == 


4 ) Type the following print () statement, and then 
press 


print ("x equals 5.") 


@ Press to remove the indent, type the 
following else line, and then press (noo. 


else: 


@ Type the following statement, which uses the 
print () function to display a message. Press (G3. 


print ("x is more than 5 but less than 11.") 
@ Click Run Python File in Terminal ([>). 


The Terminal pane appears. 


© Type a number — this example uses 5 — and press GED. 


@ Python displays the appropriate message. 


Trim size: 7.375 in x 9.25 in 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE te ax 
guy@Mac-Pro-2 ~ % /usr/local/bin/python3 /Users/quy/Dggabox/TYV_Python/Code/Asso Bizsh 
rted/if_then_elif_else_statement 
Enter a number between 1 and 20 (inclusive): 5 B) Python 

A x equals 5. 
guy@ac-Pro-2 ~ % 


eae imeem, | 
ifelse statement @ if_then_elif statement @ if.thenelfeelse_statement 3 x D>» (J «= 


Users > guy > Dropbox » TYV_Python > Code > Assorted > @ if_then_elif_else_statement > 
1 x = int(input("Enter a number between 1 and 20 (inclusive) ~* 
eM) 


print("x is greater than 10.") 


elif x <5: 
print("x is less than ro 2 ) 
elif x == 5: 


NOUBWN 


Python 3.10.0 64-bit CodeTogether @ 3 A\ 


Ln7,Col5 Spaces:4 UTF-8 LF Python #@ 0 


eoe if_then_elif_else_statement 


t ifelse statement @ if_then-elif statement @ if_then_elif_else_statement x ~@ 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ if_then_elif_else_statement > ... 
1 x = int(input("Enter a number between 1 and 20 (inclusive) iss 


2 
} print("x is greater than 10.") 
4 elif x <5: 

5 print("x is less than 5.") 

6 

7 


elif x == 5: 
print("x equals "QQ 
5 else: 
9 | print("x is more than 5 but less than a 6) 
10 


Python 3.10.0 64-bit CodeTogether @0A\0 


Ln10,Col5 Spaces:4 UTF-8 LF Python # QO | 
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Understanding Nested if Statements 


hen your code needs to make complex decisions, you can nest one or more if statements 

inside another if statement. You can use any type of if statement — a straightforward if 
statement, an if... else statement, anif... elif statement, oranif... elif... else 
statement — as either the outer if statement or the nested if statement, as needed. You may 
sometimes need to nest further if statements within your nested if statements. 


How Nested if Statements Work 


To create a nested if statement, you create the outer if statement of your preferred type and enter the 
nested if statements in the appropriate code block. Here is a pseudocode representation that shows an 
if... elif statement nested in an if... elif... else statement: 


if expressioni: 
if expression2: 
code block 1 
if expression3: 
COUCH DOCK e 2 
elif expression4: 
GOdeTDilOCis ss 
else: 
code block 4 


Here is a straightforward example of nested if statements. The outer statement is if... elif... 
elif... else, and the if block contains two nested if statements. 


if n.isalnum() : 
if n.isalpha(): 
r = "alphabetical" 
if n.isnumeric(): 
UME maaeH! 
elif n.isspace(): 
r = "space-based" 
ulate Sato akeieysvelat, (()) 2 
WAS Gia best! 
else: 
r= "a mystery" 


This example demonstrates using several string methods on the string stored in the variable n, which we 
assume has been created already. The isalnum() method returns True if the string contains alphanumeric 
characters. The isalpha() method returns True if the string contains alphabetical characters, while the 
isnumeric() method returns True if the string contains numbers. The isspace() method returns True if 
the string consists of spaces. The isascii() method returns True if the string contains ASCII characters. 
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CHAPTER 


Create Nested if Statements 


N ested if statements enable you to make complex decisions in your code. You begin the outer if 
statement with an if line that contains the if keyword, an expression that evaluates to True 
or False, and a colon. Within the if code block, an elif code block, or the else code block, 

you nest if statements, as needed. When Python evaluates that if condition or elif condition as 
true, or when it reaches the else line, Python evaluates the nested if statements and continues 
executing code accordingly. 


e In Visual Studio Code, create a new script, and then save it. eiaie a 1 |) 
 nested_it_statements x Soo 
Note: Press (9 at the end of each line. CR siees i? 
3 if neisalpha(): 
. . 4 r = "alphabetical" 
(2 } Type the following statement, which uses the input () method to el ie a ,,) 7 
iS 


prompt the user for input: 
n = input ("Type something: ") 

® Type the outer if statement, which uses the isalnum() function. 
if n.isalnum(): 


4 ) Type the two nested if statements, which use the isalpha () 
method and the isnumeric() method, respectively, and assign : a Ee 


appropriate text to the variable r. UTE 
Sree item ee See 
Users > guy > Dropbox ? TYV_Python > Code > Assorted > @ neste(wamratements > se 


1. n= input("Type something: ") a 
2 if nvisalnum(): ‘ 
3 if n.isalpha(): 

4 r = "alphabetical" 
5 if n.isnumeric(): 

6 r = “numeric” 
7 
8 


elif n.isspace(): 7 
r = "space-based's 
elif n.isascii(): 


r = "ASCII text" 


else: 
| rata te 7 ) 
te nx 
013 ey/DropboxsTrv_pytn zsh 
n0\ = 10) BJ Python 
-ASCIT : 


if n.isalpha(): 

r = "alphabetical" 
if n.isnumeric(): 

r = "numeric" 


© Jype the first e1i£ statement, which uses the isspace () method. 


elif n.isspace(): 
r = "space-based" 


@ Jype the second e1if statement, which uses the isascii() method. 


elif n.isascii(): 
r= "ASCII text" 


thon 310.0.64-bit CodeTogether @OAO — in13,Col28 Spaces UTF-8 LF Python @ O 


@ Type the else statement and its text: 
@© Click Run Python File in Terminal ([>). 


else: 
yr = "a mystery" The Terminal pane appears. 
6 Type the following print () statement to display the © Type your choice of input, and then 
information about n: press GaGp. 
print(n + "is "+ r+ ".") @ Python displays the appropriate message. 
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CHAPTER 7 


Repeating 
Actions with 
Loops 


In this chapter, you start using Python's loops to repeat actions as needed in 
your scripts. You learn to create both for loops and while loops, use loop 
control statements, and nest loops within each other to implement complex 
repetition. 


for item in collection: 
break statement 
statements 
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Understanding Python’s Loops 


hen you need to repeat actions in your code, you can use Python’s loop structures. A for loop 
lets you iterate — repeat — actions either once for each object in a collection, such as once for 
each letter in a string of text, or a specific number of times, such as 10 times. A while loop enables 
you to repeat actions as long as a condition remains True — for example, while a value is above 
a specified cutoff. When you need more complex repetition, you can nest either type of loop or a 
mixture of the two types. 


Using for Loops for Definite Iteration err ae eer ae 


statements 


A for loop enables you to repeat actions for a 
predetermined number of times. This type of 
repetition is sometimes called definite iteration. 
You can either specify the exact numerical range 
through which the loop should iterate, such as 
starting at 1 and ending at 101, or specify that Is there 
the code should loop once for each element in a ee a 
collection. For example, your code might create collection? 


a separate file for each person’s name in a list of |WiGSiciutinennevcuiecuasiconn 
names. the collection to the 
variable 


Looping through a numerical range is preferable 
when you know in advance exactly how many 
repetitions you need. Looping through a 
collection of items is helpful when you need to 
repeat an action for each item in a specific 
collection, but you do not know how many items 
that collection will contain. 


Execute the statements 


Code execution continues 


Using while Loops for Indefinite Iteration 


A while loop enables you to repeat actions as long as a condition remains True. This type of repetition is 
sometimes called indefinite iteration. 
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CHAPTER 


Repeating Actions with Loops 


For example, say you want your code to read through a file while condition: 
one line at a time, from start to end. To do this using definite lps dase 
iteration, you could determine how many lines the file contains 
and then go through line by line, identifying each line by its index 
number. But indefinite iteration using a while loop is typically 

ae Evaluate the 
faster and more efficient. In the while loop, the code starts at while 
the beginning of the file, checking that there is at least one line coeuee 
left to read. While there is at least one more line, the loop repeats. 


Execute the 


: ° ° ° birt statements 
You can also view a while loop as continuing until the condition 


becomes False. 


Code execution continues 


Nesting Loops to Create Complex Repetition 


Nesting enables you to run one or more loops inside another 

loop. For example, while you are reading each line in a file, you Sas 

may want to perform a task on each word within that line. You congtien 

can do this by nesting a for loop that works with each word on aan 


a line within a while loop that works on each line in the file. an 
Take actions 


End the End the nested loop 
outer loop 


v 


Interrupting and Continuing Loops 


When your code is executing within a loop, you may find that you have achieved the result you want and 
that continuing the loop may waste time or do something counterproductive. In such situations, you can 
use a break statement to interrupt the loop and immediately continue with the code that follows it. 


Conversely, conditions may arise in your code that require skipping the rest of the current iteration of the 
loop but then continue the loop at the next iteration rather than breaking out of the loop. You can achieve 
this by using the continue statement. 
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Understanding How for Loops Work 


ib Python, a for loop enables you to perform definite iteration, repeating an action or a set of 
actions for a specific number of times. The number of repetitions is controlled by the iterable 
collection you use for the loop. This collection can be a list, a tuple, a set, a dictionary, or even a 
string of text; you can also iterate through a collection of open files or a collection of custom objects 
you have created. For example, a for loop that works with a five-item list will iterate five times. 


Understanding the Structure of a for Loop 


The structure of a for loop is to use a variable to iterate through an iterable item. The iterable item is 
usually a collection, such as a list, a tuple, or a set. 


A for loop starts with the for keyword, as in the following pseudocode and diagram, where the italics 
represent placeholders. The in keyword precedes the iterable’s name, which a colon follows. After the colon, 
the loop’s statements are indented by four spaces. When the indentation ends, the loop ends. 


for variable in iterable: 
statements 


On the first iteration through the loop, Python for Keyword Variable inKeyword lterable Colon 
allocates to variable the first item in iterable 


and runs statements. On each subsequent 


iteration, Python allocates the next item in for variable in iterabie: 
iterable to variable and runs statements. statements 

The loop ends after Python has run statements for | 

the last item. 


Four spaces of Loop statements 
indentation 


Using a for Loop with a List 
The following statements show a for loop that works through a list: 
Heres [Atlanta "Boston, UChicagot ys UDenvyerl | 
LOG icity. incites: 

jonealiale, (alte) 
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CHAPTER 


Repeating Actions with Loops 


The first statement creates the variable cities and assigns to it a list of four cities, Atlanta, Boston, 
Chicago, and Denver. The second statement contains the for statement, which creates the variable city 
and specifies cities as the iterable. The third statement simply uses the print () function to display the 
value of the variable city. 


When you run this code, Python iterates through for Keyword Variable in Keyword Iterable Colon 
the loop four times, once for each city, and displays | | 
the following: k : Me! 
LOmsclty 11 CLleles: 
Atlanta ; : 
aotoan Prine lerey) 


Chicago | 
Denver 


Four spaces of _ Loop statements 
You can create similar loops for other collections, indentation 
including sets, tuples, dictionaries, and strings. 


Using the range () Function to Create a Numeric for Loop 


When you need to loop through a sequence of nonsequential numbers, you can put them in a set and loop 
through the set. For example, the following for loop works through the numbers 4, 7, and 11 ina set: 


ig@ne Aghbia alg (44 7/7 abil) s 
print (num) 


This approach works fine, and you can use it for sequential numbers as well if you want — for example, for 
num in (1, 2, 3). But when you have many sequential numbers, using Python’s range() function is a 
better solution. 


In the following example, the first line creates the variable r1 and uses the range () function to assign to 
it a range of 20 items. The second line creates the variable num and uses it in a for loop that iterates 
through r1. The third line, indented four spaces as usual, simply prints the current value of num. 


= range (20) 
icoe Youbiq aliel, yells 
print (num) 


This example outputs 20 numbers, starting with o and ending with 19. 


0 
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Create for Loops 


ython’s for loops enable you to iterate quickly and easily through various kinds of collection 
objects. In this section, you create for loops that iterate through three widely used types of 
collections: a list, a string, and a dictionary. 


Before we begin, here is one thing to keep in mind: Because Python uses indentation to denote control 
structures, you must indent each subordinate statement under the for statement by four spaces. 


Create for Loops 


Create a for Loop That Uses a List 1 
@ Open a terminal window and launch Python. Gees ai Se ieee ia 
MSC v.1929 64 bit Canney) ion win32 rhe : : 
Th P h n rom r ; Bye at "copyright", "credits" or "license" for more inf 
© . yt , P 8 pt appee A >>> ete = ["Atlanta", "Boston", "Chicago", "Denver" 
7 ‘ 2 >>> for city in cities: 
© Type the following statement, which creates a variable named = 
cities and assigns to it a list of four cities. Press GNC. 
cities = ["Atlanta", "Boston", "Chicago", 
"Denver" ] 


© Type the following two-line for statement, which uses the 
variable city to iterate through the items in the cities 
list. Press (G9 at the end of each of these two lines. 


for city in cities: 


print (city) Tl Connetomet- pin = —o x 
@ Press GED on the third line to end the for loop. pption See Claes io oeeseebce, dun 172622, 28:12:15) [ 
MSC v.1929 64 bit CAMD64)] on win32 
x ‘ e "help", "copyright", "credits" or "License" for more inf 
Python runs the loop and displays the following: omution 
>>> cities = ["Atlanta", "Boston", "Chicago", "Denver"] 
>>> for city in cities: 
Atlanta Bie print(city) 
Boston pata 
Chicago Sane 
Denver a |) 
xe print(s) 
Create a for Loop That Iterates Through a String e 2) 
@® Type the following statement, which creates the variable st 
and assigns a string of text to it. Press G03. 
st = "duty" 


2] Type the following two-line for statement, which uses the variable s to iterate through the letters in the 
st string. Press (m9 at the end of each of these two lines. 


for s in st: 
print (s) 


© Press GiB on the third line to end the for loop. 
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Python runs the loop and displays the following: 


d 
u 
t 


y 
Create a for Loop That Iterates Through a 
Dictionary 


@ Type the following statement, which creates the 
variable di and assigns a short dictionary to it. Press 
(@3S3 at the end of each line. 


di = { 
"country": "USA", 
"State": "Alaska", 
"city": "Anchorage" 
} 


2) Type the following two-line for statement, which 
uses the variable a to iterate through the keys in the 
di dictionary, retrieving the value for each key and 
displaying it together with the key. Press @NG9 at the 
end of each of these two lines. 


for a in dl: 
print(a + ": " 


© Press (Su on the third line to end the for loop. 
Python runs the loop and displays the following: 


+ dil[a]) 


country: USA 
state: Alaska 
city: Anchorage 


Is there a way to end a for loop early? 


CHAPTER 


Repeating Actions with Loops 7 


[BH Command Prompt - python x 


c:\Users\GuyHart-Davis>python 
Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [ 
MSC v.1929 64 bit (AMD64)] on win32 
Type "help", "copyright", "credits" or "license" for more inf 
ormation. 
>>> cities = ["Atlanta", "Boston", "Chicago", "Denver"] 
>>> for city in cities: 

print(city) 


Atlanta 

Boston 

Chicago 

Denver 

>>> st = "duty" 
>>> for s in st: 
print(s) 


"country": "USA", 
"state": "Alaska" ~< 
"city": "Anchorage" 


3 


[BH Command Prompt - python x 


>>> cities = ["Atlanta", "Boston", "Chicago", "Denver"] 
>>> for city in cities: 
print(city) 
Atlanta 
Boston 
Chicago 
Denver 
>>> st = "duty" 
>>> for s in st: 
print(s) 


“country”: "USA", 
"state": "Alaska", 
"city": "Anchorage" 


>>> for a in dl: 
Bie print(a +": "+ atp<Q 


country: USA 
state: Alaska 
city: Anchorage 
>>> | 


Yes — you can use a break statement to stop executing a loop when a particular condition is met. See the 


sections “Understanding break Statements in Loops” and “Using a break Statement to Exit a Loop Early,” 
both later in this chapter, for more information. 
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Understanding How while Loops Work 


L Python, a while loop enables you to perform indefinite iteration, repeating a block of code as long 
as a condition remains True. Python evaluates the condition before performing the action or actions, 
so if the condition initially evaluates to False, the loop never performs the actions, and execution 
continues with the next statement after the loop. By contrast, if the condition evaluates to True, and 
continues to do so, the while statement can create an infinite loop, a loop that never ends. 


Understanding the Structure of awhile Aiton eo ane ce 
Loop statements 


A while loop starts with the while keyword, 

which is followed by the condition to be 

evaluated. The while statement ends with a 

colon, after which each of the loop’s statements 

is indented by four spaces, as is standard for Evaluate the 
Python’s control structures. When the indentation ee 
ends, the loop ends. The following pseudocode ete 
and nearby diagram illustrate a while loop: 


while condition: Execute the statements 
statements 


When execution reaches the while statement, 
Python evaluates the expression. If the result is 
True, Python executes the loop’s statements; it 
then returns to the while statement and evaluates 
it again. If the result is False, execution continues 
with the first statement after the loop. 


Code execution continues 


An Example: A while Loop Using a Numeric Condition 

The following statements show a while loop that uses a straightforward numeric condition. The first line 
declares the variable a and assigns it the integer value 100. The second line starts the while loop, which 
runs while a is greater than 50. The third line uses the print () function to display the value of a, after 
which the fourth line decreases the value of a by 20. 


a = 100 
while a > 50: 
print (a) 
el = AY 


When you run this code, Python evaluates the while condition four times. The first three times, a equals 
100, 80, and 60, respectively, so the condition evaluates to True, and Python prints those values and 
performs the subtraction. The fourth time, a equals 40, so the condition evaluates to False, and Python 
does not execute the loop’s statements. 
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Repeating Actions with Loops 7 


Understanding and Avoiding Infinite Loops 


If the condition for a while loop initially evaluates to False, the loop’s statements do not run, and 
execution continues at the first statement after the loop’s end. But if the condition initially evaluates to 
True, and continues to do so, the loop will iterate without ending, in what is called an infinite loop. 


For example, the following while loop causes an infinite loop: 


one 
while one == 
print ("one: 1") 


If you run this code in a terminal window, Python displays one: 1 on each line until you stop it by 
pressing (@2nu0)+(@. This key combination gives a 
stop command, which Python registers as a SEEEVUDINEL: =e pyran 


KeyboardInterrupt event, so you see something Python 3.8.10 (default, Mar 15 2022, 12:22:08) 
a 9 [GCC 9.4.0] on linux 
like this: Type "help", "copyright", "credits" or "license" for more 
information. 
>>> one = 1 
>>> while one == 1: 
print("one: 1") 


sam@vubuntu: ~ 


Traceback (most recent call last): Baan 


File "<stdin>", line 2, in <module> one: 
one: 
KeyboardInterrupt lone: 


one: 
one: 


. . * ae one: 
To avoid creating infinite loops, you can use one or AcTraceback (most recent call last): 


more break statements in your while loops. See the Pe een a a 
sections “Understanding break Statements in Loops” __jene: 1 
a“ - = uw Pace | 
and “Using a break Statement to Exit a Loop Early, 
both later in this chapter, for information on adding 


break statements. 


>>> 
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Create while Loops 


| arse loop enables you to repeat actions as long as a condition evaluates to True. In your 
scripts, while loops can be great for giving your code the flexibility to adapt to the conditions 


under which it is running. 


In this section, you create two straightforward while loops that complete without problems. You 
also create an infinite while loop, which you then interrupt by using a key combination. 


Create while Loops 


Create a Straightforward while Loop 
@ Open Visual Studio Code and create a Python 
script. 


@ ‘ype the following statement, which creates the 
variable a and assigns to it the value 100. Press 


a = 100 


© Type the following three-line while loop, which 
runs while a is greater than 50, with each 
iteration using the print () function to display 
the value of a and then subtracting 20 from a. 
Press (09 at the end of each line. 


while a > 50: 
print (a) 
a=a- 20 


4 Click Run Python File in Terminal ([>) to run the 
loop code. 


@ Python displays the following: 


100 
80 
60 
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® while_2 x 

Users > guy > Dropbox > T; 

1 a= 100 

2 while a > 50: 


3 print(a) 
4 a=a- 3) 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE 


guy@ac-Pro-2 ~ % [] 


@o0Ao0 Ln4,Col15 Spaces:4 UTF-8 LF 


while_2 


Users > guy > Dropbox 
1 a= 100 

2 while a > 50: 
3 print(a) 
4 a=a-2 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE 
juy@Mac-Pro-2 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Co 
de/Loops/while_2 

100 

‘80 

60 

guy@Mac-Pro-2 ~ % [] 


DOA0 Ln4,Col15 Spaces:4 UTF-8 LF 


} Python # O 


® while2 x 4 i} ae 
TYV_Pythor Code > Loops while_2 


+e ax 


>} zsh guy 


3] zsh guy 


3) zsh guy 


>] Python guy 


ty ax 


>} zsh guy 


3) zsh guy 


3) zsh guy 


>] Python guy 


} Python & O 
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Create an Infinite while Loop and 
Interrupt It 


@ In Visual Studio Code, create another Python 
script. 


For example, press @ani)+GJ, click Select a 
language, and then click Python in the pop-up 
menu. Save the script under a name of your 
choice. 


@ Type the following statement, which creates a 
variable named myBoolean and assigns the 
value True to it. Press @T@9. 


myBoolean = True 


© Type the following two-line while loop, which 
runs while myBoolean evaluates to True 
and uses the print () command to display 
Continuing. ... Press @1G9 at the end 
of each line. 


while myBoolean == True: 
print ("Continuing...") 


4 ) Click Run Python File in Terminal ([>) to 
run the loop code. 


@ The script gets stuck in an infinite loop, 
outputting Continuing... once per iteration. 


© Click in the Terminal pane. 


Visual Studio Code moves the focus to the 
Terminal pane. 


@ Press Giz + GB. 


@ Visual Studio Code registers a keyboard 
interrupt, stops the code, and displays the 
KeyboardiInterrupt message. 


TIP 


CHAPTER 


Repeating Actions with Loops 7 


while_infinite 
® while_2 ® while_infinite iain: 


guy > Dropbox > TYV_Python > Code > Loops > ® while_infinite 
myBoolean = True 


while myBoolean == True: a) | 
3 print("Continuing...") 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +v Ax 


zsh guy 


guy@Mac-Pro-2 ~ % ff 


zsh guy 


> 
> 
>) zsh guy 
> 


Python guy 


while_infinite 


Ao Ln3,Col27 Spaces:4 UTF-8 LF {} Python & 
® while_2 ® while_infinite x 
Users > guy > Dropbox > TYV_Pythor 


4 [nae 
1 myBoolean = True ba 


2 while myBoolean == True: 4 
3 print("Continuing...") 


Code > Loops > @ while_infinite 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +v ax 
3) zsh gu 

Continuing... BJ zsh guy 

Continuing... >) zsh guy 


GJ zsh guy 


5. 3] Python guy 


Continuing... 
ACinuing... 
Traceback (most recent call last): 
File "/Users/guy/Dropbox/TYV_Python/Code/Loops/while_infinite", line 3, 
in <module> 
print("Continuing...") 
KeyboardInterrupt 


guy@fac-Pro-2 ~ % ff 


Ln3,Col27 Spaces:4 UTF-8 LF {} Python # QO 


Can I use the @ite)+@ keypress in a terminal window? 


Yes, you can press (@e)iie))+() to interrupt code in a terminal window, such as a Command Prompt window 
on Windows or a Terminal window on macOS or Linux. 
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Understanding break Statements in Loops 


n either a for loop or a while loop, Python enables you to include a break statement to exit 

the loop before it would otherwise end. You usually use a break statement with an if condition 
so as to exit the loop only if the condition is met. In while loops, break statements can be 
especially useful for avoiding infinite loops. 


To use a break statement, you construct your for loop or while loop as usual but include a break 
statement at the appropriate place, usually with a condition. 


The following pseudocode and nearby drawing illustrate the use of a break statement in a for loop: 


for item in collection: 
if expression: 
break 
statements 


The following example creates a variable named s, aa ee er er ars 
prompts the user to enter some text including a break statement 

z, and assigns that text to s. It creates a variable = 

named i to use as a counter. The loop uses the 
variable a to iterate through the user's string input 
one character at a time. If the character is not z, 


the print () function displays the character, and Is there 
the code increments the counter variable. If the cia 
character is z, the code displays a message giving collection? 
the character position at which z was found, and eeu ie ne ten 
from the collection 
the break statement ends the loop. to the variable 
s = input ("Enter some text including a z: ") 
i=0 Execute the 
z . ; statements 
Of a in ss 
if a == "Z"s 
print ("z found at character " + Eveleie 
str(i)) the break 
break statement 
print (a) 


1 en + 


Code execution continues 
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Using a break Statement to 
Exit a Loop Early 


CHAPTER 


7 


| as statement enables your code to exit either a for loop or a while loop before the loop’s 


collection or condition causes it to terminate. 


In this section, you create a while loop that prompts the user to guess a number between 0 and 10. 
The while loop simply specifies True as its condition; True cannot become False, so the loop is 
infinite and keeps running until the break statement is triggered. 


Using a break Statement to Exit a Loop Early 


@ Open Visual Studio Code and create a Python 
script. 


@ Type the following statement, which creates the 
variable answer and assigns to it the value 7. 


Press (GD. 


answer = 7 


© Type the following statement, which creates the 
variable prompt and assigns text to it, and then 


press GS. 


prompt = "Guess between 0 and 10: " 


@ Type the following while loop, which creates 
the variable guess, assigns to it an integer 
derived from the user's input, and compares 
guess to answer. If the two match, the loop 
displays Correct! and then ends. 


while True: 
guess = int (input (prompt) ) 


if guess == answer: 
print ("Correct!") 
break 
5) Click Run Python File in Terminal ([>) to run the 
script. 


The prompt appears. 
6] Type a number other than 7. 
The prompt reappears. 
@ Type 7. 
@ The correct! message appears. 


The break statement stops the loop. 
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® guess_the_number.py x Dy 
icers > guy > Dropbox > TYV_Python > Examples > ® guess_the_number.py 
answer = 7 me 
prompt = "Guess between @ and 10: '<& 
while True: 
guess = int(input(prompt)) = 
if guess == answer: <—@ 
print("Correct!") 
break 
PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE + “ax 
guy@ac-Pro-3 ~ % [] >] zsh guy 
>] Python guy 
Ln7,Col14 Spaces:4 UTF-8 LF {} Python 8 


guess_the_number.py 


® guess_the_number.py Xx 
Users > guy 
answer = 7 

prompt = "Guess between @ and 10: " 
while True: 

guess = int(input(prompt)) 

if guess == answer: 
print("Correct!") 


1 
2 
3 
4 
5 
6 
7 break 


guess_the_number.py 1 


Dropbox > TYV_Python > Examples > ® guess_the_numbe 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +. 4x 
guy@Mac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Pyth 2} zsh guy 
on/Examp Les/guess_the_number. pj >] Python guy 
Guess between @ and 10: 8 
Guess between @ and 10: 5 
Guess between @ and 10: 7 
Correct! 
guy@tac-Pro-3 ~ % ff 

Ln7,Col14 Spaces:4 UTF-8 LF {} Python & Q 
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Understanding continue Statements in Loops 


A: well as providing the break statement that enables your code to exit a loop early, Python 
provides the continue statement, which lets your code skip the remainder of the statements 

in the current iteration of the loop and proceed to the next iteration. Using a continue statement 
allows you to skip taking actions with particular items in a for loop’s collection or specific values in 


a while loop without terminating the loop early. 


To use a continue statement, you construct your 
for loop or while loop in the normal way but 
include a condition followed by the continue 
keyword at the appropriate point in the code. 


The following pseudocode and nearby drawing 
illustrate a while loop that includes a continue 
statement. After Python evaluates the while 
condition to True, it evaluates the second 
condition, which precedes the continue 
statement. If this second condition evaluates to 
True, Python skips the rest of the loop, returning 
to the while condition and evaluating it for the 
next iteration. If the second condition evaluates 
to False, Python executes the loop’s statements 
before returning to the while condition. 
while condition: 

if condition2: 


continue 
statements 


A for loop that includes a continue statement 
works in a similar way, except that the loop’s 
iteration is controlled by its collection rather than 
by a while condition. 


156 


0005377498.INDD 156 Trim size: 7.375 in x 9.25 in 


while condition: 
if condition2: 
continue 
statements 


Evaluate the 
while 
condition 


Evaluate the 
continue 
condition 


Execute the statements 


Code execution continues 
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Using a continue Statement in a Loop 


CHAPTER 


continue statement enables you to create a loop that skips a particular value without exiting 
the loop. You can add multiple continue statements to a loop if necessary. 


In this section, you create a for loop that iterates through a list of names, using a continue 
statement to skip those that consist entirely of uppercase letters, and displaying the remaining 


names. 


@ Open a terminal window and launch Python. 


m~ m@vubuntu: ~ 1 = 0 
Isam@vubuntu:~$ python3 
@ The Python prompt appears. Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 
@ Type the following statement, which creates evr ee ee ee ee 
the variable names and assigns to it a list poe ee Oe 
« Ti i : 
of first names. Press GC. o> Je Notice 
coats continue 
names = ["aAg" ; "Bo" , noau P nag" ; print(n) 
LE ae "Rd", "RI", "EP Ty] 
© Type the following four-line for loop, which 
uses the variable n to iterate through the 
names list. The second line uses the 
isupper () method to check whether the 
current contents of n are all uppercase; if so, 
the continue statement in the third line runs. 
If not, the print () function in the fourth line 
: my sam@vubuntu: ~ = fa} 
displays the name. Press (@i=g at the end SONGVOBUNEN = BYERS ae 
7 'ython 3.8. (default, Nov 26 2 , 20:14:08) 
of each line. [GCC 9.3.0] on Linux 
ype "help", "copyright", "credits" or "license" for more 
for n in names: information. 
. : Pai Names <= [rAd , 4 BOng Gey) Cars Diy eGius. ore erg: oak 
if n.isupper(): i" 
A P>> for n in names: 
continue bese if n.isupper(): 
print (n) Cl petnetn) 
Note: Indent the second line by four spaces, the third ‘4 
line by eight spaces, and the fourth line by four spaces. «§<Q 
Fi 
@ Press GIED to end the loop. bos 
The loop runs. 
@ Python displays the names that are not all uppercase: 
Bo 
Di 
Ed 
El 
Fi 
157 
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Understanding else Statements in Loops 


ython enables you to add an else statement to either a for loop or a while loop. Much like 

the else statement in an if structure, the else statement in a loop runs when the main part 
of the loop does not. In a for loop, the else statement runs when there are no more items in the 
collection through which the loop iterates. In a while loop, the else statement runs when the 
while condition evaluates to False rather than True. 


To use an else statement, you for item in collection: 
construct your for loop or while pear cMenee 

else: 
loop in the normal way. Where the statements2 


loop would normally end, you add the 
else keyword followed by a colon. 
After that, indented by four spaces, 
you add the statements you want 


ays * Is there 
to run when the else condition is yi uerrests 
triggered. in the 
collection? 


The following pseudocode and nearby [WSU Tait iced 


: : the collection to the 
drawing illustrate the use of an else eens 


statement in a for loop: Execute the else 
statements 
for item in collection: 
statements Execute the statements 
else: 
statements2 


A while loop that includes a 
continue statement works in a 


similar way: Code execution continues 


while condition: 
statements 

else: 
statements2 
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Using an else Statement in a Loop 7 


Ns else statement enables you to add functionality to a loop by running code when the loop has 
ceased iterating. You can add an else statement to either a for loop or a while loop. This 
capability is somewhat unusual for programming language, but you may sometimes find it useful. 


If the main part of the loop includes a break statement and execution hits that break statement, 
the loop’s else statements do not run. 


Using an else Statement in a Loop 


@ Open Visual Studio Code and create a new script. occ a 4 


® for_continue @ forelse x De 


Users > guy > Dropbox > TYV_Python > Examples > @ for_else 
1 names = ["AJ", "CC", "CJ", oe 2) 
3 =@ 


@ Type the following statement, which creates the 
variable names and assigns to it a list of first 


names. Press i 3 for n in names: 
enter) 4 if n.isupper(): <Q 
names = ["Aug" ncan nag" upg] 5 continue 
f f £ 6 print(n) r] 
* ‘ 7 it=1 
© Type the following statement, which creates 8 
the variable i and assigns to it the value o. 
Press GEG). 
i= 0 
@ Type the following for loop, which uses the 
variable n to iterate through the names list. 
If the value of n is all uppercase, the continue 
statement skips the rest of the loop; if not, the 
print () function displays the name, and the - Reet! Seas MES Ur ten OT 
value of i is increased by 1. —— 
for n in names: ® for_continue @ forelse x GC v so 
P : Users > guy > Dropbox > TYV_Python > Examples > ® for_else 
if n.isupper(): 1 names = ["AJ", "CC", "C3", "TI"] a 
continue 2 i-@ 
a 3 for n in names: 
print (n) 4 if n.isupper(): 
id += 1 5 continue 
6 print(n) | 
© Type the else statement, followed by an if tae 
statement that compares i to o and displays a 9 if i == 0: | 
pe 10 print("No mixed-case names")| 
message if it matches. © 
else : PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE + # x 
TE at — 0: onvexanptes/fr_else ga /Users/guy/Dropbox/TYV_Pyth Sane 
print ("No mixed-case names") guydiac-Pro-3 = = [] 
@ Click Run Python File in Terminal ([>). 
@ The No mixed-case names message appears, 
because each name was all uppercase. One OMIA GHEY Spaaea UTES LF ty Fyiten @ 
159 
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Understanding Loop Nesting 


hen you need to perform more complex repetition than either of Python’s types of loops allows, 

you can nest loops within loops. Nesting works with both types of loops: You can nest one for 
loop inside another for loop or nest one while loop inside another while loop. You can nest a 
for loop inside a while loop, or vice versa. 


Python enables you to nest loops and other blocks, such as with blocks and try blocks, up to a 
maximum of 20 layers deep. Usually, it is most practical to nest only a few levels deep. 


To nest loops, you construct the for © in €ivees: 

outer look in the usual way, but ee a 
then you place another loop inside 

it. The following code snippet 
and nearby drawing illustrate one 
for loop nested inside another 
for loop, which assumes that the Lees Assign to £ the next 
variables firsts and lasts have in firsts? sleet 
already been created: 


Is there 


for f in firsts: sues 
in & 
for 1 in lasts: aad 
print (f +" " 4+ 7) print (f +" " 
Python begins by executing the Assignier telnet 
outer loop. If that loop is a for Uae! 
loop, as in this example, Python 
P . . End the End the nested loop 

determines whether an item in outer loop 


the collection is available. If so, 
Python assigns the next available 
item to the loop’s variable and 
moves on to the nested loop; 

if not, Python ends the outer 
loop, leaving the nested loop 
untouched. 


Code execution continues 
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Nest Loops to Create Complex Repetition 7 


esting loops enables you to create complex repetition in your scripts. You can nest either for 
loops or while loops, as needed — or nest both if your code so demands. You can also include 
break statements, continue statements, and else statements in your nested loops. 


In this section, you use two straightforward for loops, one nested inside the other. The code is 
straightforward, but it enables you to see clearly how the nesting works. 


@} Open a terminal window and launch Python. eee cee 1 | i 


guy@Mac-Pro-3 ~ % python3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 


@ The Python prompt appears. lang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "license" for more in 
1 1 formation. 
@ Type the following statement, which creates QS «conti, soso, neat) 
the variable firsts and assigns to it a list of >>> lasts = ["Clark", "Hill", oo 3] 


>>> 


three first names. Press (TG). 
firsts = ["Ali", "Bee", "Cat"] 


Type the following statement, which creates 
the variable lasts and assigns to it a list of 
three last names. Press (QT). 


lasts = ["Clark", "Hill", "Perez"] 


4 | Type the following three-line for structure, 
which implements both for loops. The outer 
loop uses the variable £ to iterate through 
firsts; the inner loop uses the variable 1 


to iterate through lasts. The third line uses the eee Ty auy — Python — 60x28 
: is i guy@Mac-Pro-3 ~ % python3 | 
print () function to display the name produced by Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
. . lang 12.0.5 (clang-1205.0.22.11)] on darwin 
the current combination of f and 1. Press GNG9 Supe Mhelat, ecsyclsiets Neredteahion MUlcenbel Tormsrecia 
1 formation. 
at the end of each line. >>> firsts = ["Ali", "Bee", "Cat"] 
>>> lasts = ["Clark", "Hill", "Perez"] 
for £ in firsts: >>> for f in firsts: 
for 1 in lasts: ee ae ae ese "4 v~Q 
7 "W ii eee 
print (f Bs sy 1) Ali Clark 
ALG HILL 
© Press GTS to run the loop. ALA Parez 
Bee Clark 
Python displays the output, abbreviated here: eae 
Cat Clark 
Ali Clark sagt 
a erez 
Ali Hill >>> ff 
Ali Perez 
Bee Clark 


Cat Perez 
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CHAPTER 8 


Working with 
Functions 


As in other programming languages, a function in Python is a stand-alone 
section of code that performs a particular task. In this chapter, you learn 
how functions work, put Python’s built-in functions to use, and create 
custom functions of your own. 


® name_generator x 
Users > guy > Dropbox > TYV_Python > Code > ® name_generator > ... 
def generate_name(): 
# This function returns a character name 
# by taking a first name from one list, 
# a middle initial from another list, 
# and a last name from a third list. 
first = ["AL", "Bo", ney", "Dot", "Ed", "Em"] 
middle = PAs. Te *. ps, me.” "FE "] 
last = ["Adams", "Bain", "Col", "Dunn", "Ely"] 
from random import choice 
cname = choice(first) 
cname = cname + " " + choice(middle) 
cname = cname + " “ + choice(last) 
return cname 


i in range(@,9): 
print((generate_name())| 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE Di python-gy +» O f ~ x 


quyetac Pros ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/name_generator 
Ely 


Cy E. Col 
guy@fac-Pro-3 ~ % [] 


Ln16,Col27 Spaces:4 UTF-8 LF {} Python & Q 
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Understanding Functions and Their Syntax 


function is a stand-alone section of code that performs a particular task. For example, as you 

have seen earlier in this book, the input () function prompts the user to input text, while the 
print () function displays information on-screen. Python includes around 70 built-in functions that 
you can use immediately, and you can access other prebuilt functions by importing the modules that 
contain them. You can also create your own custom functions to perform operations that Python's 
existing functions do not cover. 


Understanding the Syntax ofa def Keyword Function name Parameters Colon Function description 


Function AL ; . | | | 
eee : e nection name(parameters): 
In Python, a function’s syntax looks like aa TOES UP Sore ) a 
peelings Heeler ra ck function description 
the following pseudocode and the Pe eee 


nearby drawing: return [expression] 


def function_name(parameters) : | 
""" function description""" return statement Return expression Function statements 


statements Four spaces of indentation 
return [expression] 


The following list explains the components of a function’s syntax: 


def. This keyword, short for definition, begins the function header. 

function name. Each function must have a name that is unique in its context so that your code can 
refer to the function unambiguously. 

parameters. Parameters are named items used to pass values to a function. The values passed are 
called arguments. Parameters are optional: Some functions have parameters, whereas other functions 
have none. 

: (colon). The colon denotes the end of the function header. After the colon, the function's contents are 
indented, usually by four spaces, to indicate that they are subordinate to the function header. 
function description. This description is a comment describing what the function does. The de- 
scription is optional but is usually helpful. It is sometimes called the documentation string or docstring. 
statements. The statements specify the actions that the function performs. 

return [expression]. The return statement ends the function and returns the function's result to 
the code that called the function. If the return statement specifies an expression, Python returns that 
expression. If the return specifies no expression, Python returns None, a special value. The return 
statement is optional, so some functions do not have it. Python returns None if there is no return 
statement. 
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Looking at an Example of a Function’s Syntax 
The following code shows a custom function. The nearby drawing breaks down the function’s components. 


def odd_even(n): 
UNM enobaKei eee, tere) aisle YU(Gfelell) fewe Vinneial! attene “El 
Speciirveds in sinpuce win 
if int(n)%2 == 
odd_or_ even = "Even" 
else: 
odd_or_even = "Odd" 
return odd_or_ even 


Function name Colon 


def Keyword Parameter Function description 


def odd even(n): 

[o "'"Function to return 'Odd' or 'Even' 
leone €\ Byoeveslsealeyel Vig! alioyorwbie , WWW 

ie shine (ial) GA Se We 

odd_or even = "Even" 

else: 
odd_or_even = "Odd" 
return odd_or_even 


Indentation in fourspace Return statement Function statements 
increments 


The function begins with the def keyword, after which comes the function’s name, odd_even; its 
parameter, n, in parentheses; and the colon that ends the function header. 


The second and third lines contain the function’s description in a comment delimited by three double 
quotes. After those lines is an if... else statement that creates the function's output, either Even or 
Odd, which is stored in the variable odd_or even. In the final line, the return statement returns the 
value in odd_or_even. 


Once your code has defined this function, you can call the function by entering its name and the argument 
for the required parameter, n. For example, the following statement creates the variable x1 and assigns to it 
the function’s output for the number the user types when prompted: 


odd_even(input ("Enter a number: ")) 


The function returns Even for an even number and Odd for an odd number. 
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Understanding Function Parameters and Returns 


M ost functions use one or more parameters, named items that receive arguments containing the 
values the user wants the function to manipulate. Parameters can be either required or optional, 
and a function may use both required parameters and optional parameters. However, some functions 
use no parameters at all. 


Similarly, most functions return one or more values to the code that called them. However, some 
functions return no values. 


Understanding the Four Types of Functions ( >) 
it bina f t aaa Parameters WV Parameters WV 
e combination o parameters-or-no-parame ers and vatues- Rati values Bair velass 


or-no-values gives four types of functions in Python: \ ) 
“a 


e Functions with both parameters and return values 
e Functions with parameters but no return values 

e Function with no parameters but with return values L 
e Functions with no parameters and no return values 


Parameters x Parameters x 
Return values W Return values sx 


The following subsections explore these different types, 
giving brief examples. 


Functions with Both Parameters and Return Values EUncuoninames Argument 


Many functions both use parameters to accept input and return one or | | 
more values after running. >>> abs (-99*2/50+5) 


For example, the built-in abs () function returns the absolute value of a | | 04 


number, the non-negative value of a number even if it has a minus sign. 
The abs () function has one parameter, to which you provide an 
argument containing the number for which to return the absolute value. 
For example, abs (-2) returns 2, and abs (-99*2/50+5) returns 1.04. 


Return value 


Functions with Parameters But No Return Values 


Some functions use one or more parameters to accept input but return no values. Instead, such functions 
typically perform an action. 
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For example, Python’s built-in print () function displays text on-screen rather than returning a value. This 
function uses one parameter, the string or other item you want to display. For example, print ("The 
quick brown fox, etc.") displays the text The quick brown fox, etc. provided as the argument 
for its parameter. 


Functions with No Parameters But with Return Values 


Some functions use no parameters but do return one or more values. For example, the built-in globals () 
function returns the dictionary for the current module namespace, the virtual area in which the module is 
operating. Here is an example of running the globals() function: 


>>> globals() 

{' name _': '  main_', ' doc __': None, '_ package __': None, '_ loader_!: 
CIE sis} Y_eraerdeial_alnjoyenaie JL avo) je\blaLealatiieronaicieng ss, 9 shorexel Rei, _ euatalonceheal@alsy e 
{}, ‘builtins ': <module 'builtins' (built-in) >} 

>>> 


Functions with No Parameters and No Return Values 


Some functions — relatively few — use no parameters and return no values. Such a function may either 
generate or gather its own data automatically or prompt the user to enter data. Rather than returning one 
or more values to the calling code, the function may display output — for example, by using the print () 
function. 


None of Python’s built-in functions falls into this category. Here is an example of a custom function that 
uses no parameters and returns no values: 


def day_of week(): 
from datetime import datetime 
thisday = datetime.today().strftime("%A") 
print (thisday) 


This day of week() function imports the datetime object from the datetime module. The second line 
creates a variable called thisday and assigns to it a formatted string returned using the today () method 
of the datetime object. The third line uses the print () function to display the day, such as Wednesday. 
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Using Python’s Built-In Functions 


ython includes around 70 built-in functions that you can use immediately without needing to 

load extra modules. These functions perform a variety of widely useful tasks. Some functions help 
you create and debug your code. For example, the compile() function compiles a source file into a 
code object, the exec() function executes a code object, and the breakpoint () function switches 
to the Python debugger at the specified point in a script. Other functions, such as setattr() and 
delattr(), enable you to manipulate the attributes of objects. 


Table 8-1 explains Python’s built-in functions. 


Table 8-1: Python's Built-In Functions 


Function Name _ What It Returns or Does 


abs () Returns the absolute value of the specified number. 

aiter () Returns an asynchronous iterator for an asynchronous iterable. 

all() Returns True if all elements of the specified iterable are True. 

anext () Returns the next item from the specified asynchronous iterator. 

any () Returns True if any element of the specified iterable is True. 

ascii () Returns a string containing a printable reproduction of the object with non-ASCII 
characters escaped using \x, \u, and \U escape codes. 

bin () Returns a binary string for the value the specified integer, prefixed with ob. 

bool () Returns the Boolean value — True or False — of the specified item. 


breakpoint () Switches to the Python debugger. 
bytearray () Returns a bytearray object containing a new array of bytes. 


bytes () Returns a new bytes object. 

callable () Returns True if the object appears callable. 

chr () Returns the string for the character representing the specified Unicode code point. 
classmethod() Returns a class method from the specified method. 

compile () Returns a code object compiled from the specified source file. 

complex () Returns a complex number from the specified real value and imaginary value. 
delattr () Returns the specified object with the specified attribute deleted. 

dict () Returns a new dictionary. 

dir () Returns the list of names in the current local scope or in the specified scope. 
divmod () Returns the quotient and remainder of the two specified numbers divided using integer division. 
enumerate () Returns an enumerate object from the specified iterable. 

eval () Returns the evaluated expression from the specified expression and arguments. 
exec () Executes the specified Python code object. 

filter () Returns an iterator constructed from the specified function and iterable. 

float () Returns a floating-point number from the specified number or string. 

format () Returns a formatted representation of the specified value. 
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Table 8-1: Python’s Built-In Functions (continued) 


Function Name 
frozenset () 
getattr () 
globals () 
hasattr () 
hash () 

help () 

hex () 

id() 

input () 

int () 
isinstance() 
issubclass() 
iter () 

len () 


list () 
locals () 


map () 


max () 
memoryview () 
min () 

next () 
object () 

oct () 


open () 
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What It Returns or Does 

Returns a new frozenset object. 

Returns the value of the specified attribute of the given object. 

Returns the dictionary for the current module namespace. 

Returns True if the specified object includes the specified attribute. 
Returns the integer hash value of the object, if the object has one. 

Calls Python’s built-in help system. 

Returns the hexadecimal string, prefixed with ox, for the specified integer. 
Returns the specified object’s identity, a unique integer. 

Prompts the user for input. 

Returns an integer from the specified number or string. 

Returns True if the specified object is an instance of the specified class. 
Returns True if the specified object is a subclass of the specified class. 
Returns an iterator object for the specified object. 


Returns the length of the specified object. The length is the number of items the object 
contains — for example, the number of characters in a string. 


Returns a list, tuple, or range. 
Returns the updated dictionary for the current local symbol table. 


Returns an iterator showing the specified function applied to every item in the specified 
iterable. 


Returns the largest item in the specified iterable or group. 

Returns a memory view object for the specified object. 

Returns the smallest item in the specified iterable or group. 

Returns the next item from the specified iterator. 

Returns a new object of the object class, the base for all other classes. 
Returns an octal string, prefixed with 0o, for the specified integer. 
Opens the specified file and returns a file object representing it. 


continued 
169 


Trim size: 7.375 in x 9.25 in July 8, 2022 2:50 PM 


Using Python’s Built-In Functions (continued) 


ython’s built-in functions include functions for converting values to particular data types. For example, 

the int () function returns an integer, the str() function returns a string, the list () function 
returns a list, and the tuple () function returns a tuple. Similarly, the bin(), oct (), and hex () 
functions return strings containing binary, octal, and hexadecimal representations of the value supplied. 


Other functions that are widely useful include three you have used already in this book. The 
input () function prompts the user for input, the open() function opens a file and returns a file 
object representing it, and the print () function displays output. 


Table 8-1: Python’s Built-In Functions (continued) 


Function Name _— What It Returns or Does 


ord () Returns an integer representing the Unicode code point for the specified string. 
pow () Returns the specified base number raised to the specified power, optionally using a modulo. 
print () Prints the specified objects to the text stream file. 

property () Returns the specified property. 

range () Returns a range object. 

repr () Returns a string containing a printable representation of the specified object. 
reversed () Returns a reverse iterator for the specified object. 

round () Returns the specified number rounded to the specified precision. 

set () Returns a new set object. 

setattr () Returns the specified object with the specified attribute set. 

slice () Returns a slice object for the given set of indices. 

sorted () Returns a sorted list from the specified iterable. 

staticmethod() — Returns a static method from the specified method. 

str() Returns a string from the specified object. 

sum () Returns the total of items in the specified iterable. 

super () Returns a proxy object for delegating method calls to a parent or sibling class. 
tuple () Returns a tuple from the specified iterable. 

type () Returns either the type of the specified object or a new type object. 

vars () Returns the dict ___ attribute for the specified object. 

zip() Returns tuples from the specified iterables. 


The following sections provide brief examples of putting some of the most widely used of Python’s 
built-in functions to use. 


Using the input () Function 


The input () function enables you to prompt the >>> nl = input ("Type a number 
user for input. Python receives the input as a string, between 1 and 20: ") 


but you can cast it to a different data type if needed, Tuas: é mame? Detween tad. 20e ty 
Beis 1p) 


alae 

Ss iol = ava (Gal) 
S55 igll 

aly 


as in the following example: 
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Using the sorted() Function 

The sorted() function lets you sort an iterable into either ascending order or descending order. The 
following example creates a variable named locs, assigns five place names to it, and then sorts them 
alphabetically. 

>>> locs = |MCobbiy ss Bergl wh denl!  !Allbal Dyery] 


>>> sorted(locs) 
['Alba', 'Berg', 'Cobb', 'Dyer', 'Eden'] 


To sort backward, use sorted() with reverse=True: 


>>> sorted(locs, reverse=True) 
['Eden', 'Dyer', 'Cobb', 'Berg', 'Alba'] 


Returning Binary, Octal, or Hexadecimal Strings 


The bin() function returns a string consisting of the prefix 0b and the binary value of the specified 
integer. Similarly, the oct () function returns a string consisting of the prefix 00 and the octal value, and 
the hex() function returns a string consisting of the prefix ox and the hexadecimal value. 


For example, bin (100) returns the string 061100100, oct (100) returns the string 00144, and 
hex (100) returns the string 0x64. 


Converting Binary, Octal, or Hexadecimal Strings to Decimal Values 


The int () function enables you to convert a binary, octal, or hexadecimal string to a decimal value. For 
example, int (0b1100100) returns 100. 


To convert a binary, octal, or hexadecimal number that is not in string format to a decimal value, use the 
int () function, specifying the value as a string and providing the second argument 2 for binary, 8 for 
octal, or 16 for hexadecimal. For example, int ("1100100", 2) returns 100 from the binary number 
1100100. 


Using the print () Function to Display Information 


The print () function enables you to print objects to the text stream file, giving you an easy way to 
display information to the user. For example, print ("New file created") displays the text New file 
created. 
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Create a Function with Parameters and a Return 


i this section, you create a function that uses parameters and returns a value. The function, 
calculate tip, calculates the amount of a service gratuity. The function uses two required 
parameters: The bill parameter accepts the amount of the bill, and the percent parameter accepts 
the tip percentage. The function divides percent by 100 so that the user can enter the percentage 
as a round number, such as 15, rather than as the number that actually produces that percentage, 
such as 0.15. The function returns a single value, tip, which contains the amount of the tip. 


Create a Function with Parameters and a Return 


e Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ Iype the following function header, and then 
press GG: 


def calculate _tip(bill, percent): 


Note: After the function header, indent each line of 
the function by four spaces to indicate that the line is 
part of the function. 


© Type the following statement, which divides the 
percent value by 100, assigning it back to 


percent. Press @iGp. 


percent = percent / 100 


© Type the following statement, which declares the 
variable tip and assigns to it the product of bill 
and percent. Press Ge). 


tip = bill * percent 


© Type the following statement, which returns tip to 
the calling code. Press (@7@9 once, and then press 
(@3E3 again to end the function. 


return tip 


@ Type the following statement, which uses the 
print () function to display the result of 
calculating a 15% tip on a $50 bill. Press (39. 


print (calculate_tip(50,15) ) 


Python returns 7.5, indicating a $7.50 tip. 
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guy@Mac-Pro-3 ~ % python3 yt) 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 


formation. 
o>» def calculate_tip(bill, percent) : 
eae percent = percent / > 3) 


eee 
guy@Mac-Pro-3 ~ % python3 /5| 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "License" for more in 
formation. 
>>> def calculate_tip(bill, percent): 

percent = percent / 


wae 100 

. tip = bill * percent QQ 
CS ee tip 

>>> print (catculate.tip(s0,15)) <Q 
7.5 


>>> ff 


™ guy — Python — 60x28 


July 8, 2022 2:50 PM 


Create a Function with a Parameter SUES 
But No Return 


L this section, you create a function that uses a parameter but that returns no values to the code that 
calls it. Instead of returning values, the function uses the print () function to display information to 
the user. The function is called convert liters to pints() and converts liters to U.S. pints. 


To create a function that returns no value explicitly, you can include the return statement but not 
specify a return value. Alternatively, you can omit the return statement. Both approaches have the 
same effect: The function returns no value explicitly, but implicitly it returns the value None. 


Create a Function with a Parameter But No Return 


1 ) Open a terminal window and launch Python. 


am@vubuntu:-$ python3 


@ The Python prompt appears. Recs ees Went ee: Nov 26 2021, 20:14:08) 
ype “help", "copyright", “credits" or “License” for more 
. . . inf ition. 
@ lype the following function header, which declares the convert titers to pintsttiters 
é pints = 2. * URTeTS) 
function name and a parameter called liters, and then Ey Pints = roundipints, 1) 


press (ep. 


def convert_liters to pints(liters): 


©} Type the following statement, which creates the variable 
pints and assigns to it the result of multiplying the liters 
argument by 2.11338, the appropriate factor. Press GE}. 


pints = 2.11338 * liters 


@ lype the following statement, which uses the round () 


function to round pints down to one decimal place, and Python 38.10" (eeravtt, Nov 26 2621, 20:14:68) 
then press [Enter } tee ee ae “credits” or "license" for more 


information. 
. 1 b>> def convert_liters_to_pints(liters): 
pints = round(pints, 1) & pints = 2.11338 * Liters 


pints = round(pints, 1) 


. . . es msg = str(liters) + " liters is 
© Jype the following statement, which creates a variable rh a | 
named msg and assigns to it a string derived from liters <i ere a 3) 


plus literal text. Press GG. CL oe ee 
msg = str(liters) + " liters is " 


@ Type the following statement, which completes the msg 
string by adding a string derived from pints plus literal 


text. Press G3. 


msg = msg + str(pints) + " pints." @ Iype the following statement, which 
calls the function and supplies the 
liters value: 


@ Type the following statement, which uses the print () 
function to display msg. Press (G9 twice. 


printed) convert liters to pints (3.75) 


@ Python displays the result: 


3.75 liters is 7.9 pints. 
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Create a Function with No Parameters But a Return 


n this section, you create a function that uses no parameters but that does return a value to 
the code that calls it. The function is called generate name() and returns a name created by 
combining a random first name, a random middle initial, and a random last name. 


For space reasons, the lists of names and the list of initials shown here are unrealistically short. Feel 
free to extend them with as many names as you wish. 


Create a Function with Parameters But No Return 


@ Open Visual Studio Code and create a new Python — a 1 | 
script. @ name genertor 3 x bom = 


ers > guy > Dropbox > TYV_Python > Code > @ name_generator > 
2 def generate_name(): 
# This function returns a character name 


@ Type the following function header, and then 2 
3 # by taking a first name from one list, 
ress A 4 # a middle initial f ther li 3) 
p Enter | : a 1 e initia rom another lis | 
6 


# and a last name from a third list. 


def generate name(): 


3) Type the following four lines of function 


description: 

# This function returns a character 
name 

# by taking a first name from one 
list, 


# a middle initial from another list, 
# and a last name from a third list. 


4 Type the following statement, which creates a OU anes 
variable named first and assigns to it a list of ecidgeecia me eer tee tee — 
first names. Press Gy. ET tis tiie Gaawe Gacscibe sass _ 
Piet = (halt, BoM, Ney, Doe | EAS 
"Bd", “Bm ae L 
© Type the following statement, which creates a 5 eG | 
variable named middle and assigns to it a list of 
initials. Press (QE. 
middle = ["A.", "B.", "G.", "D.", 


@ Type the following statement, which creates a 
variable named last and assigns to it a list of 
last names. Press (TG. 


last = ["Adams", "Bain", "Col", 
"Dunn" ‘é "Ely™] 
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name_generator 


7 ) Type the following statement, which imports the 
choice item from the random module, and then 


press Gey. 


from random import choice 


‘® name_generator x pyr O-. 
Users > guy > Dropbox > TYV_Python > Code > ® name_generator 
1 def generate_name(): ee 
2 # This function returns a character name 
cs # by taking a first name from one list, 
4 # a middle initial from another list, 
5 # and a last name from a third list. 
6 first = ["Al", "Bo", "Cy", "Dot", “Ed", "Em''] 
7 middle = ["A.", "B. MES") "Eo" ] 
8 last = ["Adams", "Bain", 


"Col nn", “Ely"] 
from random import — 7) 
name = choice(first) 
cname = cname +" " + croicetnisste) 
12 


6 Type the following statement, which creates the 
variable cname and assigns to it a random item 
chosen from the first list. Press (Tey. 


cname = choice (first) 


9 ) Type the following statement, which adds to cname 
a space and a random item chosen from the middle 


list. Press XS. 


cname = cname + " " + choice (middle) 


© Type the following statement, which adds to cname ee 
. eco name_generator 
another space and a random item chosen from the © renege x 13 o 
last list. Press Ge. teas io 


# This function returns a character name 
# by taking a first name from one list, 
# a middle initial from another list, 
# and a last name from a third list. 


2 
cname = cname + " " + choice(last) ; 
5 
ay Type the following statement to return cname, and Be) ie EH Wks mene eee 
9 
@ 
1 


middle = ["A.", "B.", "C.", ey MES OR 
then press (Gy twice to end the function. amas 7 
1 cname = choice(first) 
cname = cname +" " + choice(middle) 
return cname 11 cnane = came +" " 4 i 10) 
return cname 
Press to remove the indentation, and then = Mecindeniene 
. . 16 | _ print((generate_name( ))] 
type the following for loop, which uses range (0, 9) ions, ait sae eee Taare es 
with the print () function to output ten names. gupta r= 8 a/c /ser/ eur Annona 
for i in range(0,9): a A) 
print (generate name () ) #20: Ban 


Col 
guy@ac-Pro-3 ~ % [] 


® Click Run Python File in Terminal ([>). 


Visual Studio Code displays the Terminal pane. 


@ The sample names appear. 


TIP 


What other way can I get a random letter? 
You can import the string module and then use one of its tools for returning letters. As in the main text, 
type from random import choice and press (jj to import the choice item from the random 


module. Next, type import string and press (jG) to import the string module. You can then use 
choice (string.ascii_ lowercase) to return a random lowercase letter, use choice (string. 
ascii uppercase) to return a random uppercase letter, or Use choice (string.ascii letters) to 
return a random letter of one case or the other. 
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Create a Function with No Parameters 
and No Return 


function with no parameters and no return is relatively unusual because it lacks flexibility in 

both input and output. Without parameters to receive values from arguments passed by the 
calling code, the function either must contain any values it needs or must derive them from other 
sources. Without a return value, the function needs to rely on other means of communication, such 
as using the print () function to display text. 


In this section, you create a parameter-free and return-free function named show username () that 
uses the print () function to display the username under which the user is currently logged in. 


eco ‘guy — Python — 60x28 
|guy@Mac-Pro-3 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 


@ Open a terminal window and launch Python. 


@ The Python prompt appears. 


formation. 


>>> def show_username() : 
a """ This sample function uses no parameter- 
J... and returns no value.""" 


(Be from getpass import getuser. 


@ Type the following function header, which specifies no 
parameter, and then press Ge). 


def show_username(): 


Type the following two-line function definition, pressing 
(29 at the end of each line: 


"""This sample function uses no parameter 


and returns no value.""" 


4 ) Type the following statement, which imports the 
getuser() method from the getpass module, and then 


press GG: 


from getpass import getuser 


eco ™ guy — Python — 60x28 
|guy@Mac-Pro-3 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more in 


formation. 

[>>> def show_username(): 

aes """ This sample function uses no parameter 
J... and returns no value.""" 


(Gas from getpass import getuser 
you = "You are logged in as " 
you = you + getuser() + "." 


print (you). 


show_username() @ 
You are logged in as guy- 
>> ff 


Type the following statement, which creates 
the variable you and assigns a string of text to 


it. Press GYD. 


you = "You are logged in as " 


@ Type the following statement, which completes 
the you string by adding the username, 
returned by the getuser() method, and a period. 


Press GG. 


you = you + getuser() + "." 


@ Type the following statement, which uses the print () 8 ) Type the function’s name, and then 
function to display the you string. Press N09 twice. press 
print (you) @ The function runs and displays the 


message including the username. 
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CHAPTER 


Create a Function That Returns Multiple Values 8 


M any functions return just a single value, but Python enables you to create functions that return 
multiple values. In this section, you create a function that uses one required parameter and that 
returns three values. The function is called convert miles yards feet inches(); it uses a 
parameter called miles, and it returns the equivalent numbers of yards, feet, and inches. 


1) Open a terminal window and launch Python. coi Peo pis 
@ The Python prompt appears. C:\Users\GuyHart-Davis>python 
Python 3.10.3 (tags/v3.10.3:a342a49, Mar 16 2022, 13:07:40) [ 
. : . MSC v.1929 64 bit (AMD64)] on win32 
@ Iype the following function header, which Se eee tt a oir eh Eon eee ik 


declares the function with one parameter, miles. cea 


>> def convert_miles_yards_feet_inches(miles) : 
yards = miles * 1760 
Press Enter CO: = miles * 5280 > 3) 
def convert miles yards feet 
inches (miles) : 


© lype the following statement, which creates the 
variable yards and assigns to it the result of 
multiplying miles by 1760. Press ye). 


yards = miles * 1760 
© Type the following statement, which creates the 


variable feet and assigns to it the result of 
multiplying miles by 5280. Press @qG3. 


feet = miles * 5280 HHH Command Prompt = python X oh - ao x 
5 ) Type the following statement, which creates the C:\Users\GuyHart-Davis>python 
. P . . Python 3.10.3 (tags/v3.10.3:a342a49, Mar 16 2022, 13:07:40) [ 
variable inches and assigns to it the result of MSC v.1929 64 bit CAMD64)] on win32 
multiplying miles by 63,360. Press Enter § pes a , "copyright", "credits" or "License" for more inf 
>>> def convert_miles_yards_feet_inches(miles): 
inches = miles * 63360 ote Vatd sina Lesgeeg 
F feet = miles * 5280 
x @> 1:2: = miles * 63360 
6 ) Type the following return statement, which ae return yards, feet, inches <Q 
returns yards, feet, and inches. Press (Gi. >>> print(convert_niles_yards_feet_inches(2)) 
(3520, 10560, 126720) 
return yards, feet, inches pt 


@ Type the following statement, which uses the 
print () function to display the result of 
calling the function with the argument 2, 
and then press (jet). 


print (convert miles yards feet 
inches (2) ) 


@ Python displays the resulting tuple: 


(3520, 10560, 126720) 
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Create a Function with Optional Parameters 


ncluding optional parameters in a custom function enables you to make your code more flexible. 

In this section, you create a custom function that calculates the odds for a parlay bet, a 
cumulative bet on multiple outcomes. The function lets the user calculate the odds for a parlay 
involving two, three, four, or five bets using decimal odds. The function uses required parameters 
for the first two bets, because a parlay must have at least two bets. The function uses optional 
parameters for the remaining three bets, thus allowing the user to include these bets or omit them. 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


2) Type the following function header, which 
declares the function parlay with five 
parameters, oddsi through odds5, making 
the last three parameters optional by 
assigning the value None to them. 


Press GGD. 


def parlay(odds1, odds2, odds3 = 
None, odds4 = None, odds5 = None): 


©} Type the function description, and then 
press GTS. 


"""Calculate the odds for a parlay 
that contains two, three, four, or 
five bets" 


Type the following statement, which declares 
the variable p and assigns to it the result of 
multiplying odds1 and odds2. Press GNC. 


p = oddsl * odds2 
© Type the following if statement, which checks 
whether odds3 has the value None and, if not, 


multiplies p by odds3. Press @NG9 at the end of 
each line. 


if odds3 != None: 
p =p * odds3 
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|guy@Mac-Pro-3 ~ % python3 E 


eco ic Sc 1 | 


Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more in 
formation. 

>>> def parlay(odds1, odds2, odds3 = None, odds4 = None, od 
s5 = None): 

eer """Calculate the odds for a parlay that contains two 
, three, four, or five bets"™" 


eo50e ™ guy — Python — 60x28 
guy@Mac-Pro-3 ~ % python3 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "License" for more in 
formation. 
>>> def parlay(odds1, odds2, odds3 = None, odds4 = None, odd 
s5 = None): 

"""Calculate the odds for a parlay that contains two 


» three, four, or five bets" 
aon p = oddsl * odds2 
So if odds3 != None: 


p = p * odds3 
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6 ) Type two similar if statements for odds4 and 
odds5, again pressing (@j@9 at the end of each 


line: 

if odds4 != None: 
p =p * odds4 

if odds5 != None: 


p = p * odds5 


@ Type the following return statement, which 
causes the function to return the value of p to the 
calling code, and then press Ge). 


return p 
© Press GHEY again to end the function. 
The Python prompt appears again. 


9 ) Type the following statement, which uses the 
print () function to display the result of calling 
the parlay() function and supplying four bets at 
low odds. Press (3. 


print (parlay(1.72, 2, 3.6, 1.72)) 


Python displays the accumulated odds for the 
fourfold bet. 


© Press €) to reenter the previous statement, but 
this time edit the end to include a fifth argument. 


Press GG. 


print (parlay(1.72, 2, 3.6, 1.72, 4)) 


Python displays the accumulated odds for the 
fivefold bet — 85.20192 for the example. 


TIP 


What data types can I use for default values? 


CHAPTER 
Working with Functions 


eee ™ guy — Python — 60x28 
guy@Mac-Pro-3 ~ % python3 = 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "license" for more in 
formation. 
>>> def parlay(odds1, odds2, odds3 = None, odds4 = None, odd 
s5 = None): 
aera """Calculate the odds for a parlay that contains two 
, three, four, or five bets"™" 

p = oddsl * odds2 

if odds3 != None: 


p = p * odds3 

if odds4 != none: <p 
p = p * odds4 

if odds5 != None: 
p = p * odds5 


return p 
>>> & 
J) 
eoc50e ™ guy — Python — 60x28 
guy@Mac-Pro-3 ~ % python3 s 


Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [C 
lang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "License" for more in 
formation. 
>>> def parlay(odds1, odds2, odds3 = None, odds4 = None, odd 
s5 = None): 
Soo """Calculate the odds for a parlay that contains two 
, three, four, or five bets"™" 
p = oddsl * odds2 
if odds3 != None: 
p =p * odds3 
if odds4 != None: 
p = p * odds4 
if odds5 != None: 
p = p * odds5 


>>> print(parlay(1.72, 2, 3.6, 1.72)) 


>>> print(parlay(1.72, 2, 3.6, 1.72, 4)) 


You can use most data types, including None, as in this example; an integer, such as o or 1; a Boolean, 
such as True; or a string. However, in general, it is best to avoid mutable data types because although 


they work correctly the first time you call the function, subsequent calls to the function will return the 
value the last call assigned to the data type. For example, if you use an empty list as a default value, the 
first call returns an empty list, as expected, but the next call returns a list containing the values you 
assigned to the list. 
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CHAPTER 9 


Working 
with Text 


In this chapter, you learn how to use Python to work with text, which Python 
handles as strings of characters. You start by learning the essentials of 
strings and then perform essential moves with strings, such as returning part 
of a string; concatenating multiple strings into a single string; searching for 
specific values; and building strings using the interpolation operator, using 
the .format method, using f-strings, and using template strings. 


0005377500.INDD 180 


® real_title_case.py x 
Users > guy > Dropbox > TYV_Python > Code > Assorted > @ real_titile_case.py > @ make_title 


def make_title(sT): 


rlist = [] 
rs = we 
for word in sT.split(): 
if not word.isupper() and word not in lwords: 
word = word.title() 
rlist.append(word) 


if not rlist[@].isupper(): 
rlist[@] = rlist[0].title() 

if not rlist[-1].isupper(): 
rlist[-1] = rlist[-1].title() 


for word in rlist: 
rs +=" "+ word 


rs = rs.strip() 
return rs 


def main(): 


sT = input("Enter the title: ") 
print (make_title(sT)) 


if _.name__ == "__main_": 


main() 
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Learn the Essentials of Strings 


i this section, you learn the essentials of strings: with what strings are in Python, how you create 
single-line strings and multiline strings, and the tools that Python provides for working with 
strings. You also learn a little about character codes and character sets, the symbols that computers 
use to represent text — and emoji — on the screen. 


Understanding What a String Is 

A string is an ordered sequence of characters, such as abcd or The quick brown fox. You can create a 
string by assigning text within quotes to a variable. For example, the following statement creates a variable 
named animali and assigns The quick brown fox to it: 


animall = "The quick brown fox" 


Because the characters have a specific order, each string is immutable, which means you cannot change it. 
However, you can take the string, manipulate it, and then assign the manipulated string either to the same 
variable again or to another variable. 


A string can contain anywhere from zero characters up to as many characters as your computer's memory 
can handle. Most strings fall between these two extremes. 


Understanding How You Create Strings 


When creating a string, you delimit its contents with quotes. To delimit any particular string, you can use 
either a single quote at the beginning and the end or double quotes at the beginning and the end. You 
cannot mix single and double quotes to delimit a single string — for example, you cannot start a string 
with a single quote and then end it with double quotes. 


The following example creates a variable named str1 and assigns a string to it using single quotes: 


str1l = 'New York! 

imilarly, the following example creates a variable named st r2 and assigns a string to it using double quotes: 
tr2 = "Grand Canyon Junction" 

sing single quotes enables you to include double quotes as part of the string. Here is an example: 

tr3 = 'Ann said, "I want to go to New York."! 


ikewise, using double quotes enables you to include single quotes inside the string. Here is an example: 


tr4 = "Bill replied, 'We should stay here.'" 


To create a multiline string, you can use either triple single quotes or triple double quotes to mark the start 
and end of the string. Creating a multiline string enables you to control where the line breaks occur in the 
output. Here is an example: 


str5 = """Conference Room C 


This meeting room is for senior management only.""" 


In a multiline string, you can also control the layout of text by including tab characters and new-line characters. 
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Working with Text 


Understanding Python’s Tools for Manipulating Strings 


Python provides a wide variety of methods for manipulating strings. Each string method returns a new value, 
so it does not change the original string. However, you can assign a changed string back to the variable 
that contained it, which gives a similar effect to having changed the original string. 


The section “Meet Python’s String Methods,” later in this chapter, gives you an overview of the string 
methods that Python offers. Subsequent sections of the chapter show you how to put many of the string 
methods to work. 


Understanding Character Codes and Character Sets 

A character set is a list of symbols used to display text and emoji on a computer. Different character sets 
may have different characters for the same character codes, the numbers that identify particular characters 
within a character set. 


For example, the widely used American Standard Code for Information Interchange — ASCII for short — 
contains 255 characters, including uppercase and lowercase Roman letters, such as ABC and abc; Arabic 
numerals, such as 123; punctuation marks, such as ? and !; and control characters such as Delete, Escape, 
and space. The Unicode character set, which greatly extends ASCII, has many more than 100,000 characters 
that include the characters used in more than 100 languages, not to mention thousands of emoji. 


When using Python 3, you will normally use the Unicode character set, which Python 3 is designed to 
support fully. However, earlier versions of Python 2 may use ASCII rather than Unicode. 


Unicode supports different formats for encoding its characters. These formats are called Unicode 
Transformation Formats, abbreviated to UTF. The most widely used Unicode Transformation Format is UTF-8, 
which uses 8-bit character units to encode the characters. UTF-8 uses up to four character units to encode a 
character. Eight bits is one byte, so UTF-8 uses up to four bytes of space to encode a given character. 


This book assumes you are working with UTF-8. 
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Create Single-Line Strings 


o store text, Python enables you to create either single-line strings or multiline strings. 

Single-line strings are good for general use in code, whereas multiline strings can be useful for 
presenting text laid out with line breaks and indentation. This section shows you how to create 
single-line strings; the next section, “Create Multiline Strings,” covers multiline strings. 


To delimit a single-line string, you use either paired single quotes or paired double quotes. If 
needed, the string text can include quotes of the opposite kind — for instance, a string delimited 
with double quotes can include single quotes for quotation or apostrophes. 


@ In Visual Studio Code, create a new script, and then =e = Qa x 


7 ® stringsipy x py. O- 
save it. C: > Users > guy pe thon > Code > @ strings1.py | 
1 stra = 7 
@ Type the following partial statement, which creates a 
variable named st ri, and then press (@i09: 
strl =" 
@ Visual Studio Code’s Auto Closing Quotes feature 
automatically inserts the closing double quotes for REE SC ee 
you. Normally, this is helpful. stings py 1 x by O- 
oe ee ee — 


© for this example, press GE) to delete the second 
pair of double quotes, and then type Anna looked 
surprised., including the period. 


Visual Studio Code places a wavy red underline 
beneath the string text to indicate there is a problem. 


J File Edit Selection View Go Run Terminal Help strings1.py-VisualStudioCode — OO X 


© Move the pointer over the underlined string. Sn sring iter 9 ternal io (AM B~ 


@ The pop-up balloon shows the error that the Pylance 1 strt'» Tame Looked pursed | 
extension has identified: String literal is unterminated. 
@ Iype the missing double quotes to close the string, 
and then press Guow. 


Visual Studio Code removes the wavy red underline. 


>) File Edit Selection View Go Run Terminal Help strings!.py-VisualStudioCode —- OF xX 
: : : ringst.py X atti en 
@ Type the following statement, which creates a variable ——————EE _ 
named str2 and assigns to it a string that contains Bes Senee ote snpraces" eG) | 
quotes, and then press Guo: : d 
str2 = 'Anna said "Who?" to Bill.' 
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Visual Studio Code starts a new line. 


@ Type print(str. 


@ Visual Studio Code displays the Auto 
Complete list, showing the available items 
starting with the letters str, st, and s, in 
that order. 


6 Click the item you want to enter — in this 
case, stril. 


Note: You can also select an item from the 

Auto Complete list by “typing down” to it — 
typing further characters until you identify it 
unambiguously — or by pressing €3 or &. Once 
you have selected the item, press to enter it. 


Visual Studio Code enters that item in the 
code, including the closing parenthesis 
required to complete the function 
statement. 


@ Press GiS3 to create a new line, type the 
following statement to display str2, and 
then press (200% again: 


print (str2) 
@© Click Run Python File in Terminal ([>). 


Visual Studio Code displays the Terminal 
pane. 


Visual Studio Code runs your code. 


@ The two strings appear in the Terminal pane. 


Is there another way of including 
quotes inside a string? 

Yes. You can “escape” the quotes, telling 
Python to treat them specially. To escape 


a quote character, you put a backslash 


before it. For example, in str1 = 'Ann 
is Bill\'s cousin', the \' escapes 
the apostrophe. 
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strings1.py - Visual Studio Code 
® stringsi.py x 
C: > Users > guy > ‘ox > TYV_Python > Code > @ strings1.py >... 
1 stri a looked surprised." 

2  str2 = Yrna said “Who?” to Bill.' 

3 print(str) 


fel str1 

fe] str2 

(e] StrOrBytesPath 
(e] StrPath 

% StopIteration 

% SupportsTrunc 

@ setattr 

% StopAsyncIteration 
% SupportsRDivMod 
% SupportsRead 

% SupportsReadline 
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® stringsi.py x 

C: > Users > guy > Dropbox > TYV_Python > Code > @ strings1.py >... 
1 stri = “Anna looked surprised." 

str2 = ‘Anna said “Who?” to Bill.' 

print(str1) 

print(str2) 


ubwn 


strings1.py-VisualStudioCode — OO X 
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PROBLEMS OUTPUT DEBUG CONSOLE TERMINAL >] Python ++ ~ 


Windows PowerShell 
Copyright (C) Microsoft Corporation. All rights reserved. 


Install the latest PowerShell for new features and improvements! https://ake.ms/PSwWindows 


PS C:\Users\guy> & "C:/Program Files/Python31@/python.exe” c:/Users/guy/Dropbox/TYV_Python/Co 


de/strings1.py 


Anna looked surprised. 
Anna said “Who?” to Bill: 
PS C:\Users\guy> 


How do I include a backslash in a string? 
You can either escape the backslash by preceding it with another 
backslash — for example, path = "C:\\Windows\\Temp" 
stores the string C:\Windows\Temp — or create a raw string by 
preceding the string with R or r, such as path = R"C:\ 
Windows\Temp". Escaping works for other special characters — 
such as \b for Backspace and \f for form feed — as well, but it 
causes an error with any nonspecial character. 
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Create Multiline Strings 


hen you need to include line breaks and spacing in a string, you can create a multiline string in 
either of two ways. The first way is to place either triple single quotes or triple double quotes 
at the beginning and end of the string; between the delimiting quotes, you lay out the string on as 
many lines as you want using carriage returns, spaces, and tabs, as needed. The second way to create 
a multiline string is to enter it on a single line of code but include new-line characters or carriage- 
return characters within the string. 


Create Multiline Strings 


Create a Multiline String Using Triple Quotes ee | ae ae. 


® string_multi_tpy x Deities 
C: > Users > guy > Dropbox > TYV_Python @ string_multi_t.py 
1 strMulti = ai 


@ In Visual Studio Code, create a new script, and then 
save it. 


@ In the Editor pane, type the following partial statement, 
which creates a variable named strMulti and starts 
assigning a string to it: 


strMulti = """To: 


Note: You can use either triple single quotes or triple double 
quotes for any multiline string, but you cannot mix and match 


single quotes and double quotes for the same string. a a 
@As you enter each double-quote character, Visual Studio = Co" =e 
Code automatically enters a matching one to the right of © > > Oopon) TP on = 

the insertion point, closing the string for you. : dette astiton a 
4 Anytown, IND 46555""" 7 

3 ) Press Enter § : print(strMulti 
The insertion point and the three closing double-quote 
characters move to a new line. (ecu, (RBA “Tenis ooeoia, aloes Blomen +~ DO @ > x 

Copyright (C) Microsoft Corporation. All rights reserved. 

4 ) Type the contents of the string, using spaces for indentation Install the latest Povershell for nau features nd Improvements! nets://ak.e8/PSMndous 
and pressing | Enter) to create new lines, as needed. Here is Fe a Wkersien> 8 celia Files/Python31@/python.exe” ¢:/Users/guy/Dropbox/TYV_Python/Co 
an example: ore B ) 

Anytown, IND 46555 
strMulti = """To: Tn 


Indefinite Distributors . 

555 Industry Blvd. @ Type the following print () statement to 

Anytown, IN 46555""" display strMulti, and then press (QS: 
5) Press @3. print (strMulti) 


The insertion point moves to after the three closing double- @® Click Run Python File in Terminal ([>). 


quote characters. @ The multiline string appears in the 


Note: You can also press (jt) to move the insertion point to Terminal pane. 
the end of the line. 
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Create a Multiline String Using Carriage- 
Return and New-Line Characters 


In Visual Studio Code, create a new script, and 
then save it. 


@ In the Editor pane, type the following statement, 
which creates a variable named Multi2 and 
assigns to it a string that includes tab characters 
and new-line characters. Press @3. 


Multi2 = "\t\tIntroduction\n\ 
nMaking a strong first impression 
has never been more important." 


© Type the following statement, which adds 
further text to Mult i2, and then press GG: 


Multi2 = Multi2 + "\n\n\tHere is a 
handy technique you can use to add 
impact to your first impression." 


Note: If Visual Studio Code does not wrap long 
lines of code, click View on the menu bar, and then 
click Word Wrap, placing a check mark next to it. 


@ Type the following print () statement to 
display Mult i2, and then press GG: 


print (Multi2) 
@ Click Run Python File in Terminal ([>). 


@ The multiline string appears in the Terminal 
pane with the tab characters replaced by tabs 
and the new-line characters replaced by new 
lines. 


3 
Python 3.10.0 64-bit CodeTogether @0A\0 Ln3,Col1 Spaces:4 UTF-8 LF Python & Q 
Multi2 
Multi1 ® Multi2 x o- 2 


Python 3.10.0 64-bit CodeTogether @0 A 0 
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Multi2 


Multi1 & Multi2 Dy 


Users > guy > Dropbox > TYV_Python > Code > @ Multi2 > ... 
1 Multi2 = "\t\tIntroduction\n\nMaking a strong girst 
impression has never been more important.' 
2 Multi2 = Multi2 + "\n\n\tHere is a handy technique 
you can use to add impact to your first inpression. “4p im 


Users > guy > Dropbox > TYV_Python > Code > @ Multi2 > ... 

1 Multi2 = "\t\tIntroduction\n\nMaking a strong first 
impression has never been more important." 

2 Multi2 = Multi2 + "\n\n\tHere is a handy technique 


you can use to a impact to your first impression." 
3. print(Multi2) 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +. ax 


guy@Mac-Pro-2 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code 
/Multi2 


Introduction 
Making a strong first impression has never been more important.. 
Here is a handy technique you can use to add impact to your first i 


mpression. 
guy@ac-Pro-2 ~ % ff 


Ln 4,Col1 Spaces:4 UTF-8 LF Python & QO 


What is the difference between a carriage-return character and a new-line character? 
In a string, the carriage-return character, \r, makes the following text start at the beginning of the line, 
but it does not move down to the next line. By contrast, the new-line character, \n, moves down to the 


next line and makes the text start at the beginning of the line. 


Usually, you will want to use \n to start the text on a new line. Using \r on its own causes any subsequent 
text to overwrite part of the existing text, which is not what you normally want. 
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Meet Python’s String Methods 


ython includes nearly four dozen methods for working with strings. This section gives you 

an overview of these methods, dividing them into five categories: methods for checking and 
changing the case of text, such as islower() and lower (); methods for returning information 
about strings, such as isalpha() and startswith(); methods for finding and replacing in 
strings, including find() and replace (); methods for laying out string data, such as center () 
and format (); and methods for transforming string data, from encode() to zfill(). 


Later in this chapter, you put the most useful of these methods into action. 


Methods for Checking and Changing Case 
Table 9-1 lists Python’s methods for checking and changing the case of strings. 


Table 9-1: Methods for Checking and Changing Case 


Method What It Returns 

capitalize () The string with an initial capital applied 

casefold() The string in lowercase letters 

islower () True if all characters in the string are lowercase 

istitle() True if the string is lowercase with initial caps 

isupper () True if all characters in the string are uppercase 

lower () The string in lowercase letters 

swapcase () The string with its original casing reversed 

title () The string in title case — with the first letter of each word capitalized 
upper () The string in uppercase letters 


Methods for Returning Information About Strings 
Table 9-2 lists Python’s methods for returning information about strings. 


Table 9-2: Methods for Returning Information About Strings 


Method What It Returns 
count () The count of occurrences of the string in another string 


endswith () True if the string ends with the specified string 

True if all characters in the string are alphanumeric 
True if all characters in the string are alphabetical 
True if all characters in the string are ASCII characters 
True if all characters in the string are decimals 

True if all characters in the string are digits 


True if the string is a valid identifier 


( 
isalnum() 
isalpha () 
isascii() 
isdecimal () 
isdigit () 
isidentifier () 


isnumeric () 
isprintable() 
isspace () 
startswith () 
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True if all characters in the string are numeric 
True if all characters in the string are printable 
True if all characters in the string are whitespaces 
True if the string starts with the specified string 
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Methods for Finding Within Strings 
Table 9-3 lists Python’s methods for performing find operations in strings. 


Table 9-3: Methods for Finding and Replacing in Strings 
Method What It Returns 
find () The position of the specified value in the string 
index () The position of the specified value in the string 


rfind() The position of the specified value in the string, searching from the end 
rindex () The position of the specified value in the string, starting from the end 


Methods for Laying Out String Data 
Table 9-4 lists Python’s methods for laying out string data. 


Table 9-4: Methods for Laying Out String Data 
Method What It Returns 
center () A centered string 
format_map () The string formatted as specified 
format () The string formatted as specified 


ljust () The left-justified version of the string 
rjust () The right-justified version of the string 


Methods for Transforming String Data 
Table 9-5 lists Python’s methods for transforming string data. 


Table 9-5: Methods for Transforming String Data 
Method What It Returns 


encode () The string encoded in the specified way 
expandtabs() Sets the tab size to the specified number of white spaces (default 8 
join () A string containing an iterable’s elements joined together 


ilfsiiereatie)(()) The string with leading spaces removed 
maketrans () A translation table 


partition () A three-element tuple containing the text before the specified string (searching from the 
beginning), the specified string, and the text after the specified strin 

replace () A string with the specified search value replaced with the specified replacement value 

rypartition() A three-element tuple containing the text before the specified string (searching from the end), 
the specified string, and the text after the specified string 

aefejonLakic ()) Splits the string at the specified separator, and returns a list 

aefsjieaealyo)(()) The string with trailing spaces removed 

fsjouatie {()) A list consisting of strings split at the specified value 

splitlines() A list containing strings created by splitting the specified string at the line breaks 

strip () The string with leading and trailing spaces removed 


translate () A translated string 
aie a ILA, ()) The string filled with zeros at the beginning to bring it to the specified length 
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Return Information About a String 


python includes a wide variety of string methods that enable you to return information about 
strings. For example, you can use the isupper() method or the islower() method to 
determine whether the string is uppercase or lowercase, respectively; or use the isalpha() method, 
the isnumeric() method, or the isalnum() method to check whether the string is numeric, 
alphabetic, or alphanumeric — again, respectively. You can use the startswith() method to 
check a string’s start, use the endswith() method to check its end, or use the count () method to 
return the number of occurrences of another string inside that string. 


Return Information About a String 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


(2 } Type the following statement, which creates a 
variable named stri and assigns a string to it, 


and then press (yey): 


strl = "Sometimes a string is just a 
string." 


3) Type the following statement, which uses the 
isalnum() method, to check whether the string’s 
characters are all alphanumeric, and then press (@e3: 


str1l.isalnum() 


Python returns False, because the spaces and 
the period are not alphanumeric characters. 


Note: You could also try other tests, such as 
strl.isalpha(), strl.isdecimal (), or 
strl.isnumeric(). 


@ Type the following statement, which uses the 
endswith() method to check the string’s end, 


and then press (Sei): 
strl.endswith(".") 


Python returns True because the string ends with 
a period. 


© Type the following statement, which uses the 
startswith() method to see if str1 starts 
with “The”, and then press (Ve): 


strl.startswith ("The") 
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‘Command Prompt - python 


Microsoft Windows [Version 10.0.22000.376] 
(c) Microsoft Corporation. All rights reserved. 


C:\Users\guy_h>python 
Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 
64 bit CAMD64)] on win32 


Type "help", "copyright", "credits" or “License” for information. 
>> strl = "Sometimes a string is just a string." 
>>> str1.isalnum()| 


i 


Command Prompt - python x > pv = od x 


Microsoft Windows [Version 10.0.22000.376] 
(c) Microsoft Corporation. All rights reserved. 


C:\Users\guy_h>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 
64 bit CAMD64)] on win32 

Type "help", "copyright", "credits" or "License" for more information. 
>>> strl = "Sometimes a string is just a string." 

>>> str1.isalnum() 

False 

>>> strl.endswith("." 

True 

>>> strl.startswith("The")| 
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Python returns False. 


6 ) Type the following statement, which uses the 
count () method to return the number of instances 
of “string” in str1, and then press Gilcu: 


strl.count ("string") 


Python returns 2, because str1 contains two 
instances of “string”. 


@ Type the following statement, which uses the 
isprintable() method to determine whether 
all the string’s characters are printable, and then 


press GIS: 
strl.isprintable() 


Python returns True, because all the string’s 
characters are printable. 


Note: Characters such as a line feed or a carriage 
return are nonprintable and cause the 
isprintable() method to return False. 


© Type the following statement, which checks 
whether the string is a valid identifier in Python, 
and then press Guu: 


strl.isidentifier () 


Note: A valid identifier must contain only 
alphanumerics — the letters a to z and the 
numbers 0 to 9 — and underscores. It cannot 
contain spaces. It can start with a letter or an 
underscore, but not with a number. 


Python returns False, because the string contains 
spaces and punctuation. 
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[EH Command Prompt - python x ev = o x 


Microsoft Windows [Version 10.0.22000.376] 
(c) Microsoft Corporation. All rights reserved. 


C:\Users\guy_h>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 
64 bit C(AMD64)] on win32 

Type "help", "copyright", "credits" or "license" for more information. 
>>> strl = "Sometimes a string is just a string." 

>>> str1.isalnum() 

False 

>>> strl.endswith(".") 

True 

>>> strl.startswith("The") 

False 

>>> str1.count("string") 

2 

>>> str1.isprintable() 


Command Prompt x t+ v = Qo x 


Microsoft Windows [Version 10.0.22000.376] 
(c) Microsoft Corporation. All rights reserved. 


C:\Users\guy_h>python 

Python 3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 
64 bit CAMD64)] on win32 

Type "help", "copyright", "credits" or "license" for more information. 
>>> strl = "Sometimes a string is just a string." 

>>> str1.isalnum() 

>>> strl.endswith(".") 

>>> strl.startswith("The") 

>>> str1.count("string") 


>>> str1.isprintable() 


True 
>>> stri.isidentirierO <Q 
False 


How can I return the number of characters in a string? 


Use the len() function, which returns the length of the string as a number of characters. For example, 
print (len(str1)) makes Python display the number of characters in str1, including spaces. 


The 1en() function works on sequences and collections but returns a TypeError error if you use it on an 
object that has no length. For example, if you run len() on an int object, Python returns TypeError: 
object of type 


'int' has no len(). 
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Transform and Clean Up a String 


A: you saw in the section “Meet Python’s String Methods,” earlier in this chapter, Python provides 
a comprehensive suite of methods for manipulating strings. In this section, you use some of 
those methods to clean up a string by trimming off leading spaces — extra spaces at the beginning 
of the string — and trailing spaces —extra spaces at the end — and replacing double internal 
spaces with a single space. You then use the split () method to split the string into a list and the 
partition() method to split the string into a three-element tuple. 


Transform a String 


e Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ ype the following statement, which creates a 
variable named 1m and assigns a string to it, 


and then press (@Te%3: 


lm =" West Oregon 19411 " 


Note: The 1m string has three leading spaces, 
double spaces between the words, and three 
trailing spaces. 


©} Type the following statement, which assigns 
to 1m the string with its leading spaces and 
trailing spaces removed, and then press (23: 


lm = lm.strip() 


Note: To remove only leading spaces, use the 
lstrip() method — for example, lm.1lstrip(). 
To remove only trailing spaces, use the rstrip () 
method. 


4 ) Type the following statement, which displays the 
contents of 1m, and then press (Ie¥9: 
print (1m) 
Python displays the trimmed string: 
West Oregon 19411 


5 ) Type the following statement, which uses the 
replace () method to replace each instance of 
two spaces with a single space and assigns the 
results to 1m. Press GG. 


Im = lm.replace("  ", " ") 
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|guy@Mac-Pro-2 Code % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 


jon. 
>>> lm =" West Oregon 19411 <Q ] 
>>> | 


eee 
|guy@Mac-Pro-2 Code % python3 ie 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 

2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 

jon. 

[>>> lm = " West Ore 194117 =" ] 

>>> Lm = lm.strip() ] 


lest Oregon 19411 
[>>> lm = lm.replace(" ", " »~& ] 
>>> ff 


~) Code — Python — 66x26 
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@ Asgain, use the print () function to display the 
contents of 1m. Press (ey). 


print (1m) 


Python displays the string, now with a single space 
between words. 


West Oregon 19411 


7) Type the following statement, which creates a variable 
named list1 and assigns to it the list of strings 
created by splitting the string in 1m at its spaces using 
the split () method. Press Ge). 


listl = lm.split(" ") 


© Type the following statement, which uses the print () 
method to display list1, and then press Gey: 


print (list1) 
Python displays the list of three strings: 
['West', 'Oregon', '19411'] 


9 ) Type the following statement, which creates a 
variable named tuple1 and assigns to it the three- 
element tuple resulting from dividing 1m using the 
partition() method. Press GG3. 


tuplel = lm.partition('Oregon') 


€© Type the following print statement to display the 
contents of tuple1, and then press (ey: 


print (tuplel) 
Python displays the three-element tuple: 


('West ', 'Oregon', ' 19411') 


[>>> lm = " West Oregon 19411 Cs ] 


[>>> lm = lm.replace(" ", " ") ] 
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e060 © Code — Python — 66x26 
guy@Mac-Pro-2 Code % python3 i 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more informat 
jon. 


>>> Im = lm.strip() ] 
>>> print(1m) ] 
West Oregon 19411 


print(Lm) | 


West Oregon 19411 
>>> Listl = lm.split(" <Q ] 
>>> print(list1)fJ 


eo0e Ti Code — -zsh — 66x26 
guy@Mac-Pro-2 Code % python3 g 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 

2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 

jon. 

>>> Im =" West Oregon 19411 # ] 

>>> Lm = lm.strip() ] 

>>> print(1lm) ] 


>>> Llistl = lm.split(" ") ] 
>>> print(list1) ] 


['West', 'Oregon', '19411'] 
>>> tuplel = tn. partition ‘oregon") QED ] 
rint(tuplel) ] 


(‘West ', 'Oregon', ' 19411') 
>>> 


Note: The tuple appears in parentheses rather than brackets. Note also that the tuple’s first string includes a 


trailing space and the third string includes a leading space. 


How do I pad a string with zeros to make it a specific length? 
Use the z£il1() method, which fills the beginning of the string with zeros so that it contains the specified 


number of characters altogether. For example, if the variable named a5 contains the string 628 but you need 
an 8-digit number, you could use a5. zfil1(8) to produce the string 00000628. Note that the zf£i11 () 
method is working with strings that appear to contain integer data, not with integers themselves. 
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Return Part of a String via Slicing 


ften, you will want to return part of a string rather than a whole string. For example, you may 
want to get the first three characters, the last ten characters, or a specific part in the middle. 


Python uses the term slice to mean chopping up a string like this; you can also slice other objects, 
such as lists, tuples, and sets. When slicing, you specify the start point and the end point for the 
substring you are returning. You can also specify a step argument — for example, to return every 
other character or every third character. 


@ Open a terminal window and launch Python. : as 


ib ~ h 
@ The Python prompt appears. Byes speny mere Nov 26 2021, 20:14:08) 
[Gcc 9.3.0] on Linux 


. . nhelpr.. 4 ight>,. 7 dits" bal | iz ik inf ion. 
@ Iype the following statement, which creates Be rere ‘cantttever production stattsties (3p st 


>>> 


a variable named txt1 and assigns a string 
to it, and then press NS: 


txtl = "Cantilever production 
statistics 93" 


© Type the following statement, which creates a 
variable named first3 and assigns to it the 
first three characters of txt1. Press (G9. 


first3 = txt1[0:3] 


© Type the following statement, which uses the 
print () function to display first3, and 


then press GIG: 
sam@vubuntu: ~ 
print (first3) lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
7 7 [Gcc 9.3.0] on Linux 
Python displays Can, the first three characters Type "help", "copyright", "credits" or "license" for more information. 
“ >>> txt1 = "Cantilever pr tion statistics Q3" 
in txtl. >>> first3 = txtif0:5)-<e) 
rint(first3) 
7 . jCan 
@© Type the following statement, which creates a pee last2 = txti[-2: 
variable named last2 and assigns to it the last 


two characters of txt1. Press GS). 


last2 = txt1[-2:] 
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6 } Type the following statement, which uses the 
print () function to display last2, and then press 
[Enter 3 
print (last2) 

Python displays Q3, the last two characters in txt1. 


@ Type the following statement, which creates 
a variable named middle10 and assigns to it 
10 characters from the mid part of txt1. 


Press GSD. 


middle10 = txt1[22:32] 


© Type the following statement, which uses the 
print () function to display middle1o0, and then 


press Ge: 


print (middle10) 


Python displays statistics, the characters in 
positions 22 to 32 in txt1. 


@© Type the following statement, which creates a variable 
named m10odd and assigns to it every other character 
from middle1o. Press Ge. 


ml0odd = middlel10[::2] 


€© Type the following statement, which uses the print () 
function to display m10o0dd, and then press (39: 


print (m10odd) 


Python displays saitc, every other character from 
statistics. 


TIPS 


How do you use colons when slicing a string? 

Slicing as shown here takes three arguments — start, 
end, and step — separated by colons. For example, 
txt1[1:5] returns the second through the fifth characters 
of txt1; txt1[1:5:2] uses a step value of 2 and so 
returns the second and fourth characters of txt1. You can 
omit start to use the object’s start, omit end to use the 
object’s end, and omit step to use the default step, 1. 


CHAPTER 


Working with Text 


sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


", "copyright", "credits" or "license" for more information. 
>>> txt1 = "Cantilever production statistics Q3” 
>>> first3 = txti[0:3] 
>>> print(first3) 
can 
>>> Last2 = txti[-2:] 


Q 
>>> middlei0 = Pca 7) 
>>> print(middl 


.e10 
statistics 
>>> 


sam@vubuntu: ~ 


lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


", "copyright", "credits" or "license" for more information. 
>>> txti = "Cantilever production statistics Q3” 
>>> first3 = txt1[0:3] 
>>> print(first3) 
ican 
>>> Last2 = txti[-2:] 
>>> print(last2) 


>>> middle10 = txt1[22:32] 
>>> print(middle10) 
statistics 

>>> midodd = middle10 

>>> print(m10odd). 


What does a negative number mean in 
slicing? 

A negative number indicates starting from 
the end of the string rather than the 
beginning. For example, txt1[-13:] 
returns the portion of txt1 from the 
13th character, counting back from the 


end of the string. 
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Concatenate and Repeat Strings 


Python enables you to join two or more strings together to make a single longer string. Computer 
languages call this concatenating strings — literally, “chaining them together.” In Python, you 

use the concatenation operator, +, to concatenate strings. You can repeat strings using either the 

concatenation operator or the repetition operator, *. 


The + operator simply appends the second string to first string, so if you concatenate the string 
Anita and the string Hernandez, you get the string AnitaHernandez. When concatenating 
strings, you will sometimes need to add spaces or punctuation to produce the string you need. 


Concatenate and Repeat Strings 


Join Strings Using the Concatenation Operator 1 aneaenge cca 
licrosoft Windows [Version 10.0.22000.466] 
@ Open a terminal window and launch Python. 


¢) Microsoft Corporation. All rights reserved. 


@ The Python prompt appears. 


; : : A 
(2 Type the following statement, which creates a variable 
named fname and assigns a string to it, and then 
press (TE): 
fname = "Anita" 
© Type the following statement, which creates a 
variable named mi and assigns a string to it, and 
then press (NC: 
mi = mer BH Comman: \d Prompt - python - o x 
: . . licrosoft bol te [Version ree races 466) 
4 ) Type the following statement, which creates a variable bs deni nes een enn 
. . . Users\guy>python 
named 1name and assigns a string to it, and then Ben589 de, Sth chtasd) icon nse ie 4 2021, al 00:18) : 
is ype "help", “copyrig » "credits" or "license" for more in 
press Gig: oe fnane,=, "anita 
>> m1 = 
lname = "Hernandez" >> Iname = “Hernandez’ =p Se, ae 
33 print ful inane) + + m+". "+ rnane <Q 
. . . nita lernanaez 
© Type the following statement, which creates a variable > 6 


named fullname and assigns to it a concatenated string, 
and then press (@e3: 


fullname = fname + " " + mi + ". " + lname 


6 } Type the following statement, which displays fullname, 
and then press (Sjcy): 


print (fullname) 


Python returns Anita C. Hernandez, the full name 
made up of fname, mi, and 1name, with spaces and a 
period. 
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Command Prompt - python = Oo x 


ficrosoft Windows [Version 10.0.22000.466] 
(c) Microsoft Corporation. All rights reserved. | 


Repeat a String Using the Concatenation 
Operator 


@ Type the following statement, which creates a 
variable named myText and assigns a string to 


it, and then press GG}: 


:\Users\guy>python 


>> fname = "Anita" 
h "on 


>> mi = 
= Ux *W >> Iname = "Hernandez" 
myText = Draft >> fullname = fname + " "+ mi +". " + Iname 


>> print(fullname) 
nita C. Hernandez 1) 
>> myText = "* Draft *' 

>> myText + myText + ee 2) 
'* Draft ** Draft ** Draft *' 

>> 


Note: The myText string uses spaces to increase 
readability. 


(2 } Type the following statement, which uses the 
concatenation operator to repeat myText three 
times, and then press (ey: 


myText + myText + myText 


Python returns * Draft ** Draft 
** Draft *. 


Command Prompt 


ficrosoft Windows [Version 10.0.22000.466] 
(c) Microsoft Corporation. All rights reserved. | 


Repeat a String Using the Repetition 
Operator 


@ Type the following statement, which creates 
a variable named sChar and assigns a string 
to it, and then press (Te: 


sChar = "#" 


:\Users\guy>python 


>> fname = "Anita" 


>> Iname = "Hernandez" 

>> fullname = fname + " "+ mi +". " + Iname 
>> print(fullname) 

nita C. Hernandez 

>> myText = "* Draft *" 

>> myText + myText + myText 

'* Draft ** Draft.** Draft *' 


@ lype the following statement, which uses the 
repetition operator to repeat sChar 12 times: 
>> sChar = "#5 


>> sChar * 12 
‘ HHHEAHERHEHE 
>> 


sChar * 12 


Python returns '############', which you 
might use as a display element, such as a 
separator. 


How do I concatenate a string and an integer? 
You need to cast the integer to a string; the same goes for any other nonstring data type you want to 
concatenate with a string. For example, say you have a variable named inti that contains an integer and a 


variable named str1 that contains a string. You could use str(int1) + stri to concatenate an integer 
version of int1 with str1; trying to concatenate the two without casting the integer to a string, such as 
intl + stri, returns a TypeError. 
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Search for One String Inside Another String 


hances are that your code will often need to search for one string inside another string. Python 

provides four methods for performing searches within strings. You can use the find() method 
to search for one string within another, starting from the left end of the string; and the rfind() 
method to search starting from the right end. Similarly, you can use the index() method to return 
the position of one string within another string, again starting from the left end; or the rindex () 
method to return the position starting from the right end. 


1) Open a terminal window and launch Python. 


@ The Python prompt appears. 
Type the following statement, which creates a 
string called text1, and then press (ey): 
textl = "It's raining cats, dogs, 


and more cats." 


© Type the following statement, which uses the 
find() method to find the word “cats”, and 


then press G3G3: 


text1l.find("cats") 


Python returns 13, the character position at 
which the first instance of “cats” starts in 
the string, counting from the beginning and 
including spaces. 


@ Type the following statement, which uses the 
index () method to locate the word “cats”, 


and then press (Sci): 


textl.index ("cats") 


Python again returns 13, the character position 
at which the first instance of “cats” starts. 


Note: See the tip for information on the difference 
between the find() method and the index () 
method. 


5 ) Type the following statement, which uses the 
find() method again but adds two optional 
arguments, and then press (ey: 


textl.find("cats", 20, len(text1) ) 
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1 sam@vubuntu: ~ 


lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 


[Type "help", "copyright", "credits" or "license" for mor: ormation. 
> text1 = "It's raining cats, dogs, and more cats." 
b>> text1.find("cats" ff 


ial sam@vubuntu: ~ Q = = o x 


sam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 

[GCC 9.3.0] on Linux 

Type "help", "copyright", "credits" or "license" for more information. 
>>> text1 = "It's raining cats, dogs, and more cats." 

>>> text1.find("cats") 


113 
>>> text1.index("cats"). 


13 
>> texti.find("cats", 20, renctexts) GD 


July 1, 2022 9:29 PM 


CHAPTER 


Working with Text 


Python returns 34, the character position at 
which the second instance of “cats” starts. 


sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


Note: The find(), index(), rfind(), and [Gcc 9.3.0] on Linux 


Type "help", "copyright", "credits" or "license" for more information. 


rindex() methods all take three arguments. The >>> text1 = "It's raining cats, dogs, and more cats.” 
>>> text1.find("cats") 


first argument, value, is required and gives the 3 
‘ . >>> text1.index("cats") 
search value. The second, start, is optional and hs 
7 os . text1.find("cats", 20, 1 text1 

gives the start position; the default is 0. The Sinn ee eae ener 
third, end, is optional and gives the end position; [7 ‘***-"*tné sets? 


the default is the string’s end. 


6) Type the following statement, which uses the 
xfind() method to find the word “cats”, 
but this time finding the instance nearest the 
right end of the string. Press (3. 


textl.rfind("cats") 


Python again returns 34, the character 


e,e : a“ Ww 
position of the instance of “cats” nearest the  [BRivinunru:-s pythons 


end of the string. Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 


sam@vubuntu: ~ 


7 . Type "help", "copyright", "credits" or "license" for more information. 
@ Type the following statement, which uses the >> texti =""1t's raining cats, dogs, and nore cats.” 

: ‘ >> text1.find("cats") 
rindex() method to find the instance of n3 
>>> texti.index("cats") 


“cat” nearest the end of the string, and then fia 


press ‘Enter § text1.find("cats", 20, len(text1)) 
>>> texti.rfind("cats") 
: 134 
text1l.rindex ("cats") >>> texti.rindex(*cats") <p 
34 
Python once more returns 34. iz 


What is the difference between find() and index () ? 
The find() method and the index () method work almost alike, and you can use whichever you prefer; 
similarly, rfind() is almost identical to rindex(). But there is one key difference: Whereas find() and 


rfind() return -1 if they cannot locate the search string, index() and rindex() return an error — 
specifically, ValueError: substring not found. When searching, your code should either handle this 
error or use find() instead of index() and rfind() instead of rindex(). 
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Check and Change String Capitalization 


ython includes various string methods for determining the capitalization of a string of text and 

applying your preferred capitalization. For example, you can use the isupper() method to check 
whether the string is all capitals and then use the title() method to apply “title case” — the first 
letter of each word capitalized, the remaining letters lowercase. 


In formal English grammar, however, title case uses all lowercase for articles, some prepositions, 
and some conjunctions that are not the title’s first word or last word. In this section, you create a 


function that applies such “real” title case to a string. 


Check and Change String Capitalization 


1) In Visual Studio Code, create a new script, and 
then save it. 


2) In the Editor pane, type the following statement, 
which creates the variable lwords and assigns 
to it the list of words that should appear in 
lowercase. Press G@NG9. 


lwords = {ta "an", "and", "ag", 
"at", "but", "by", "£or", "how", 
"Gf", "in", "of", "on", "off", "nor", 
"or", "go", "the", "to", "up", "via", 
"with", "vet" } 


Note: The example list of words is not complete. 


© Press GSD again to leave a line blank, and then type 
the following statement, which declares the make_ 
title() function and specifies that it uses the sT 
argument. Press (ej again. 


def make _title(sT): 


4 ) Type the following statement, which declares the 
variable rlist. This variable will hold the list of 


results. Press Ge). 


rlist = [] 


@ Type the following statement, which declares the 
variable rs. This variable will hold the string that the 
make_title function returns to the code that calls 


it. Press GSD. 


rs = un 
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@ real_title case.py @ 


Users > guy > Dropbox > TYV_Python 
1. Words = {"a" 


real_title_case.py 


® real_title_case.py @ Dy O- 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ r 
1 words = tas" 
"how", "i 


, 
» "on", "off", 
"with", "yet"} 


, 
"to", "up", "via", 
3 def make_title(sT) j 
4 rlist = 4) 
5 an 


a: 
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6 } Type the following statement, which begins a for om. 0... ae Ore 
loop. The loop uses the split method to divide the > a0 
value in the sT variable into words and uses the word 
variable to iterate through those words. Press (ijey9. 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ real_title_case.py >» @ make_title 

1 words = {"a", "an", "and", “as, "at", "but", "by", "for", sesso 
of", "on", “off”, "nor", "or", "so", "the", 
"to", “up", "via", "with", "yet"} 


3 def make_title(sT): 
4 rlist = [] i 


for word in sT.split() 6 ae in sTesplitQ): q 
. , if not word.isupper() and word not in 7) 
@ Type the following statement, which uses an if 

statement to check whether the value in word is 


both not uppercase and not one of the words in 
lwords. Press GS. 


if not word.isupper() and word not in 
lwords: 


© Type the following statement, which uses the 
title() function to apply title case to the string 


Python 3.10.0 64-bit CodeTogether @5A0 Ln8,Col13 Spaces:4 UTF-8 LF Python 


in the word variable, assigning the result to the —_ == 
1 @ real_title_case.py7 @ pele. 
word = word.title() ae geet oil — 
5 rau 
9 ) Type the following statement, which uses the a: |. 1” at eked oe Dabaelabe aa tones | 
append () method to append the string in the ‘oS 
word variable to the list in rlist. Press Gi. = if not rlist[0].isupper(): | 
12 rlist [0] = rust titted QQ) 
13 


rlist.append (word) 


© Press (S09 again, creating a blank line, and then 
type the following statement, which checks whether 
the first item in rlist is uppercase and, if not, 
uses the title() method to apply title case to it. 
Press (fe once more. 


if not rlist[0].isupper(): Sim sana ena enceropetert eS Rig Gag Spee a UTES Cee 
rlist[0] = rlist[0] .title() 


TIP 


Why does the make title() function check whether the word is all uppercase? 
As written, this function assumes that any word in all uppercase is an abbreviation or acronym that should 
remain in uppercase. So if not word.isupper() verifies that the word is not uppercase before the 


function changes the word’s case. 


In a fuller implementation, the function might first check whether the entire string was uppercase and, if 
so, prompt the user to choose suitable casing. 


continued 
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Check and Change String Capitalization (continued) 


he code you write in this section contains a function called make _title() that iterates through 

the words in a string you enter — for example, a paragraph that will be a heading. The function 
ignores words in uppercase, assuming them to have been entered that way deliberately. Uppercase 
aside, the function ensures that the first word and the last word in the string each have an initial 
capital; it compares each other word to a list of words that need to be lowercase and applies an 
initial capital or all lowercase, as appropriate. 


® Press to reduce the indent, and then ra We se 
. . ® real_title_case.py 9+ x 
type the following statement, which checks EE merge pe 
. . . 2 
whether the last item in rlist is uppercase and, def make_title(st): 
. * list = [] 
if not, uses the title() method to apply title ee 
. f d in sT.split(): 
case to it. Press Enter zi Fak erin) and word not in lwords: 
d= d.title() 
if not rlist[-1].isupper(): rst. appendvord) 
7 = — 7 =, 7 if not rlist[@].i Q: 
rlist[-1] = rlist[-1].title() os eat ae 
‘ % é if not rlist[-1].isupper(): 
@® Press GIG again, creating a blank line, and rList(-il = rlistt-1).titte(-—QB) 
then press to reduce the indent. tor ard. dn cist: 
rs te" "4+ wort <Q) 


© Type the following for loop, which creates 
the variable rs, iterates through each item in 
vrlist, and adds to it each item, preceded by a 


space. Press ‘Enter } 


for word in rlist: 
rs += Le word Python 3.10.0 64-bit CodeTogether @4A8 Ln18,Col9 Spaces:4 UTF-8 LF Python 


@& Press GIEY again, creating a blank line, and 
then type the following statement, which uses 


eee real_title_case.py 
® real_title_case.py 9+ @ Dy O 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ real_title_case.py 


the strip() method to remove any leading and eer 

trailing spaces from the string in rs, assigning G. ||. aueoaneansecenaeine \ 
a if not dei 0 id ‘d not in lwords: 

the result back to rs. Press (ey. es asi aes 


9 rlist.append(word) 


rs = rs.stri 
s P ( ) 1 if not rlist[@].isupper(): 


. 7 12 rlist[0] = rlist[0].title() 
® Type the following statement, which returns the 13 | af not Flist -11cisupper(): 
: . 14 rlist[-1] = rlist[-1].title() 
rs String as the output of the make title 15 
. 16 for word in rlist: 
function. Press Guay. a. | | wet? eee 


return rs 


18 
rs = es.strip\) QU) 
return rs 


€ Press GTQ again to create another blank line, 
and then type the following statement to declare 
the main() function. Press Ge. 


Python 3.10.0 64-bit CodeTogether @6A9 n23,Col5 Spaces:4 UTF-8 LF Python 


def main(): 
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@ Type the following statement, which creates the 
variable sT and assigns to it the string that the 


user types. Press (ct). 
sT = input("Enter the title: ") 


@®) Type the following statement, which displays the 
result of running the make_title function on 
the st string. Press Gu). 


print (make_title(sT) ) 


(19) Press (Sn) again, creating a blank line, and 
then type the following if statement to verify 
that the main() function is being called from 
within the script: 


Le name == " main ": 
main () 
Run the Script 


@ Click Run Python File in Terminal ([>). 
The script starts running. 
@ The prompt appears. 


@ Type the text to which you want to apply title 
case, and then press Gey). 


@ Include an uppercase word if you want to verify 
the casing of abbreviations and acronyms. 


@ Put one of the lowercase words last to verify the 
casing. 


@ The title-case string appears. 


TIP 


Working with Text 


real_title_case.py 


® real_title_case.py 9+ @ 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ real_titie_case.py 


3 def make_title(sT): 

4 rlist = [] 

5 ro" 

6 for word in sT.split(): 
¥ if not word.isupper() and word not in lwords: 
8 word = word.title() 

rlist.append(word) 


if not rlist[@].isupper(): 


12 rlist[@] = rlist[@].title() 
13 if not rlist[-1].isupper(): 

14 rlist[-1] = rlist[-1].title() 
15 

16 for word in rlist: 

17 rs +=" "+ word 

18 

19 rs = rs.strip() 

20 return rs 

21 


22 def Q: 
sT = it("Enter the title: = 17) 
(make_title(sT)) 
26 «if _name_ == a 19) 
27 | main() | 


Python 3.10.0 64-bit 


CodeTogether @3 


eco real_title_case.py 


Users > guy > Dropbox > TYV_Python > Code > Assorted > @ real_title_case.py > @ make_title 


3 def make_title(sT): 

4 rlist = [] 

5 rou" 

6 for word in sT.split(): 

7 if not word.isupper() and word not in lwords: 

8 word = word.title() 

9 rlist. append (word) 

10 

11 if not rlist[@].isupper(): 

12 rlist[0] = rlist[@].title() 
13 if not rlist[-1].isupper(): 

14 rlist[-1] = rlist[-1].title() 
15 
PROBLEMS OUTPUT TERMINAI UG CONSOLE 


guy@Mac-Pro-2 ~ % /usr/local/bin\gython3 /Users/quy/Dropbox/TYV_Python/Code/pesorted/real_ 
title_case. py 
nter the title: configuring a TCP/IP stack to speed your network up 
Configuring a TCP/IP Stack to Speed Your Network Up 
guy@Mac-Pro-2 ~ % 


What is the difference between the casefold() method and the lower () method? 
Python’s lower () method is the method you would normally use to create a lowercase version of a string. The 
lower () method effectively converts uppercase letters to their lowercase equivalent — for example, converting 


Spaces:4 UTF-8 LF Python 


® real_title_case.py x 1 ed % [tlre 


Python 3.10.0 64-bit CodeTogether @0 A\0 n6,Col5 Spaces:4 UTF-8 LF 


CHAPTER 


te ax 
zsh 
DB) Python 


Python 


A to a, B to b, and Z to z. However, Python provides the casefold() method as well, which lowercases a 
wider range of letters than the Lower () method does; this can be helpful for matching strings. For example, 
German uses the Eszett character, &, in place of some instances of double-s. Because 8 is a lowercase character, 
the lower () method does not change it; however, the casefold() function changes it to ss. 
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Meet Python’s Tools for Building Strings 


i: build the text strings you need, you can use Python’s string-formatting tools. In this case, 
“formatting” means getting the text in the string into the appropriate order and presenting its 
characters in the way you want — for example, as a number with a certain number of decimal places. 


Python provides four different ways to format strings: string interpolation, the . format method, 
f-strings, and template strings. Each has its own strengths and weaknesses, and you may well find 
some more useful than others. You should be familiar with all four ways for when you encounter 
them in others’ code. 


Learn Python’s Four Ways of Formatting Strings 


Python offers four means of formatting strings. Each uses a different method of indicating where you want 
to substitute your variables. 


Formatting Method Example 

Interpolation operator SayHi = "Hello, %s!" %"Vanessa" 

. format method strl = "{} uses {}.".format ("New York", "EST") 
f-strings short es seWal {fipvetsttedl ya 


Template strings from string import Template 
tl = Template("Destination: $place.") 


The following subsections discuss these four methods in more detail. The following four main sections 
provide examples of working with each method. 


Format Strings with the Interpolation Operator 
Interpolation means putting one thing into another thing — in this case, inserting one string or other value 
into another string. 


Python uses the interpolation operator, %, to indicate a placeholder at which you want to place an 
interpolated value. You can insert values of different types by using the codes in the following list. 


Value Type Interpolation Code 
String ss 
Single character Se 


Hexadecimal 
Octal 
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To insert a single value, you mark the spot in the string with the appropriate interpolation code. The 
following example specifies interpolating a string where %s appears: 


sayHi = "Hello, %s!" 


After the string, you enter the interpolation operator, %, followed by the value. The following example 
specifies a name as the string value: 


SayHi = "Hello, %s!" %"Vanessa" 
This statement produces the string "Hello, Vanessa!". 


If you have two or more items to interpolate, you put the values in a tuple after the interpolation operator. 
The following example interpolates a string and two integers: 


Wwe 


myMsg = "%s, you have %i fingers and %*d thumbs." %("Sam", 8, 2) 


This statement produces the string "Sam, you have 8 fingers and 2 thumbs." Both %i and 3d 
specify interpolating an integer, so use whichever you prefer. 


String interpolation using the interpolation operator is straightforward for a small number of interpolations 
but becomes awkward for larger numbers of interpolations. 


Using the Interpolation Operator, % 


Interpolation Codes Values 
| Interpolate string Interpolate integer —__Interpolate integer | | String Integer Integer | 


Wwe 


myMsg $S, you have %i fingers and %d thumbs." %("Sam", 8, 2) 


we 


$S, you have %i fingers and %d thumbs." %("Sam", 8, 
A 


"Sam, you have 8 fingers and 2 thumbs." 


continued 
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Meet Python’s Tools for Building Strings (continued) 


ython’s f-strings provide a streamlined method of inserting strings from variables, from a 

dictionary, or from a class object. Introduced in Python 3.6, f-strings make your code easier to 
read and run faster than code using the interpolation operator or the . format method, so they are 
generally your best option for interpolating strings. 


Format Strings with the . format Method 


The second method of formatting strings uses the . format method of the string object. The . format 
method uses a pair of braces, {}, as a placeholder for each item you want to insert in the string. The 
following example uses two placeholders: 


str1 = "{} uses {}." 


After the string, you enter : aa 
the .£ormat method, Using the . format Method by Position 


followed by a tuple 
containing the items you Interpolation Codes - format Values 
want to insert. Here is an | Interpolate item —_Interpolate item | method | String String 


example: | | 


strl = "{} uses = "{} uses {}.". format ("New York", "EST") 
{G) aes Eoramealt 


("New York", "EST") 


This statement creates the df | 

variable str1 and assigns =  tises )) 2" format New York" “EsT") 
to it the string "New York | 
USES HSa we 


In this example, Python 
inserts the items 

in the order in which they Using the . format Method with Index Numbers 
appear in the . format 


tuple. This is easy enough, Interpolation Codes . format Values 
but you can also use Interpolate item 2 Interpolate item O Interpolate item 1 method ItemO Item1 Item 2 


strl = "New York uses EST." 


zero-based index numbers or 
keywords to insert the items 
in a different order. The 
following example uses 
index numbers: 


= "{2} is Gmr@ {0}{1} hours.".format("+", 5, "EST") 


= io) se GMD {Ol 1} hours. format (uel: 
aA 


Bee = {a} 

is GMT {0}{1} 
hounse ue formate (lcs 
5, wnisw?)) = "EST is GMT +5 hours." 
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Format Strings with the . format Method (continued) 


This statement creates the variable str2 and assigns to it the string "EST is GMT +5 hours.". Python 
inserts the third item, "EST", at the {2} placeholder; the first item, "+", at the {0} placeholder; and the 
second item, 5, at the {1} placeholder. 


Similarly, you can use keywords to insert terms in your preferred order. The following example uses keywords: 
sil eS Wiiraly; (Ue) als [wel (wep U omic (lal, Wea A, TSW, WAST liol) 


This statement creates the variable si and assigns to it the string "1 kg is 2.2 1b.". Python inserts 
each value at the place specified by its keyword: the value 1 at the w1 keyword, the string "kg" at the u1 
keyword, and so on. 


Using the . format Method with Keywords 


Interpolation Codes Values 
Interpolate Interpolate Interpolate Interpolate . format 
keyword wl keywordul keyword w2 | keyword u2 method | Keyword1 Keyword 2 Keyword 3 Keyword 4 


iw) ul ae wo) aoe! tormak (will wee ke z=" M) 


MW le {w2} {u2}.".format (w1=1, a eo Ma eof eet sie 2 


Wivkguis 2.0) 1a. 0 


Format Strings with f-Strings 
The third method of formatting strings is to use formatted string literals, known as f-strings for short. 


To build an f-string, you use the f prefix and then create the string, including the placeholders needed for 
the items you want to insert. The f prefix can be either lowercase or uppercase, but lowercase is more 
common. 


continued 
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Meet Python’s Tools for Building Strings (continued) 


A: you saw earlier in this section, f-strings are the string-building tool recommended for general 
purposes because of their ease of use and their speed of execution. However, if your Python 

code gets the user to input strings, use template strings rather than f-strings for the input. Template 
strings provide greater security, preventing a user from entering a carefully crafted formatted string 
that accesses variables within your code and exports data from them. 


Format Strings with f-Strings (continued) 

Unlike with the . format method, the placeholders in an f-string cannot be blank. You can populate the 
placeholders with variables, with items from a dictionary, or with items from a class. 

The following example creates two variables and then includes them in an f-string: 


unitl = "qt" 
Manic = Weyl 

Std oe unwed equal sms 2m qumate2)) ee! 

This statement creates the variable str4 and assigns to it the f-string 1 qt equals 32 oz., inserting 
the contents of the unit1 and unit2 variables at their placeholders. 


Using an f-String with Variables 


Create the Variables 
ieniied = Wejet 
Vinaic® = Weopalw 


f Identifier Interpolation Codes 
| Interpolate item Interpolate item 


Seed = ei una l) eqiabs so. (unde oy a" 


hieset) a Wik ene Seieuley 24 or,” 


In the following example, the first statement creates a dictionary called d1 that contains values named ul, 
u2, al, and a2. The second statement then inserts these values in an f-string. 


"gal W ¥ 
Gey : How 
"al": 2, 
"a2": 256 


} 


str5 = £'{dl["al"]} {d1["ul"]} equals {dl["a2"]} {d1["u2"]}.' 
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This statement contains the variable str5 and assigns to it the f-string 2 gal equals 256 oz., 
inserting the contents of the al, ul, a2, and u2 items from the di dictionary at their placeholders. 


Using an f-String with a Dictionary 


Create the Dictionary 


= W We W W W We W W WT W. W We 
di Ub. “Wiel Wes. er Wid OS ees IES) 


f Identifier Interpolation Codes 
| Interpolate item Interpolate item | Interpolate item Interpolate item 


Eda Ved etude equals iam tao dd aos 


Ui gal equallis’ 32 oz5! 


Format Strings with Template Strings 


The fourth method of formatting strings is to use template strings. Template strings enable you to define 
placeholders and then insert strings in them by using a mapping object. 


You would normally use template strings when your code gets the user to enter input. Template strings 
provide security features that f-strings, string interpolation, and the . format method do not, preventing 
the possibility that the user might enter a formatted string that accesses variables and exports data. 


To use a template string, you first import the Template class from the string library. The following 
statement shows an example: 


from string import Template 


You then create an instance of the Template object containing a string that has the format you want the 
input to have. You include one or more $ placeholders in the string to indicate where you want to insert 
data. For example, the following statement creates a template called t1: 


Template("Destination: $place.") 


You then use the substitute method of the Template object to tell Python which variable you want to 
substitute for which placeholder. 


tl.substitute(place=input ("Enter the destination: ")) 


This statement makes Python prompt the user for the location, which it then substitutes for the placeholder, 
giving a string such as "Destination: Alaska". 
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Build Strings with the Interpolation Operator 


sing the interpolation operator, %, is Python’s oldest method of building strings. Although 

Python now offers more efficient methods of building strings, the interpolation operator still 
works fine and is still widely used, so you are likely to encounter it in other people’s code even if you 
decide not to use it in your own code. 


This section provides examples of working with the interpolation operator in a terminal window. 
See the subsection “Format Strings with the Interpolation Operator” in the previous section, “Meet 
Python’s Tools for Building Strings,” for general information about using the interpolation operator. 


@ Open a terminal window and launch Python. : ae 


The Python prompt appears. rag Cerone Nov 26 2021, 20:14:08) 
y prompt app 
[GCC 9.3.0] on Linux 
3 “ Type "help", "copyright", "credits" or 4% nse" for more information. 
@ ype the following statement, which creates pop mabey =" “Todey ts Xs.” ee D | 
a variable named myDay, assigns text and the 
string interpolation operator %s to it, and then 


provides the string to insert. Press (TG. 
myDay = "Today is %s." $"Friday" 


3 ) Type the following statement to display the 
contents of myDay, and then press 3G): 


myDay 


Python displays the string 'Today is 


Friday.' 
4 ) Type the following statement, which creates a : =norimime 
variable named dte; assigns a string including san@vubuntu:~S python3 
. c - Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
. o3 5! li 
th ree interpolation codes; and provides a tuple eee Thelpt, "copyright", "credits" or "license" for more information. 
containing the data to interpolate. Press GG). ee a ee 
"Today is Friday.' 
dte = "$i $s %d" %(21, "June", 2022) nae of 2) <Q 


‘21 June 20 


>>> 


@ Iype the following statement to display the 
contents of dte, and then press GG: 


dte 


Python displays the string '21 June 2022'. 
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6 } Type the following statement, which creates = LISI 
a variable named calc1, assigns a string 
including three interpolation codes; and 


lsam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[Gcc 9.3.0] on Linux 

Type "help", "copyright", "credits" or "license" for more information. 


provides a tuple containing two integers p>> myDay = "Today is xs." %"Friday" 
>>> myDay 
"Today is Friday.’ 

and a float. Press Gir. ne deere Ade xd" %(21, "June", 2622) 
>>> dte 

calcl= = "%$1i/%i = SE" %(10,4,2.5) "21 June 2022' <Q 


>>> sates = "%i/%i = %F" %(10,4,2.5 
calci 
@ Type the following statement to display the 7 = 2.508000" 
contents of calc1, and then press (33: 


calel 


Python displays the string '10/4 = 
2.500000. ! 


6 Type the following statement, which prompts the 
user to enter their name, and then press (20): 


sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


[Gcc 9.3.0] on Linux 
Type "help", "copyright", "credits" or "license" for more information. 
>>> myDay = "Today is %s." %"Friday” 


print ("Your initial is " + 


input ("Enter your name: ") SSS nypay 
"Today is Friday." 
[oy + ™.™) >>> dte = "Mi %s Xd" %(21, "June", 2022) 


>>> dte 

‘21 June 2022' 

>>> calci = "Ki/%i = %F" %(10,4,2.5) 
>>> calcl 


‘10/4 = 2.500000' 
>>> print("Your initial is "_+ input("Enter your name: ")[0] + <Q 
Enter your name: Wilson. 


Your initial is W. 
>>> 


Python displays the Enter your name: prompt. 


@ Type a name, and then press GID. 


Python displays a message including the first letter 
of the name, such as Your initial is Ww. 


What is the difference | To make my code run faster, should I rewrite my code that uses the 
between the %d interpolation operator? 
operator and the %i This is up to you — but it may not be worth the effort. Although f-strings 


operator? provide better performance than the interpolation operator, the improvement is 
There is no real difference. | unlikely to be significant unless your code builds many strings. That said, you 
Both codes are for signed may want to update the code to use f-strings in the long run because they 
integer decimals. make your code easier to write, read, and maintain. 
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Build Strings with the . format Method 


. in Python 2.6, the . format method for building strings is still widely used, so you 
are likely to encounter it in other people’s code even if you do not use it yourself. The . format 
method uses a pair of braces, {}, as a placeholder for each item to insert in the string; after the 
string, the . format keyword is followed by a tuple containing the items to insert. 


See the subsection “Format Strings with the .format Method” in the section “Meet Python’s Tools for 
Building Strings,” earlier in this chapter, for general information about the . format method. 


1) Open a terminal window and launch Python. 


@ The Python prompt appears. 


@ ype the following statement, which creates the 
variable 1oc1 and assigns to it a string containing 
two placeholders. Press GJS. 


locl = "{} is in {}." 


(3 ) Type the following statement, which creates the 
variable 1oc2 and assigns to it the result of using 
the .format method to insert two strings in 


loci. Press GR. 


loc2 = locl.format("Utica", "New York 
State") 


Note: Inserting items by order is straightforward for 
small numbers of items but can become awkward with 
many items. To reuse an item, you must enter it again in 
the appropriate position in the tuple. 


@ Type the following statement, and then press (QE, 
to display the contents of loc2. 


loc2 


Python displays the string 'Utica is in 
New York State.'. 
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information. 
> locl = "{} is in {}." l 
>>> Lloc2 = locl.format("Utica", "New York state" <p ] 


eco ™ Code — Python — 57x27 

|guy@Mac-Pro-3 Code % python3 I 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for more 


>> 


ec0e ™ Code — Python — 57x27 

guy@Mac-Pro-3 Code % python3 ] 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more 
information. 

>>>" Loch = "fp asin fh 

>> loc2 = locl.format("Utica", "New York State") 


‘Utica is in New York State.' 
>>> ff 
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5 Type the following statement, which creates the 
variable m1 and assigns to it a string containing 
four placeholders that use zero-based index 
numbers. Press GG). 


m1 = "{2} {1} equals {0} {3}." 


@ Type the following statement, which creates the 
variable m2 and assigns to it the result of using 
the .format method to insert four items in 


mi. Press GG. 


m2 = ml.format("1/16", "hammer", 1, 
W foot") 


@ Type the following statement, and then press GIG, 


to display the contents of m2. 


m2 


Python displays the resulting string, '1 hammer 


equals 1/16 foot.'. 


8 ) Type the following statement, which creates a 


variable named wt, assigns a string that includes 


two placeholders using keywords, and then uses 
the .format method to provide the keywords. 


Press Gey. 


wt = "{w1l} {ul} equals {w2} {u2}.". 


format (wl=1, w2=112, ul="cwt", u2="l1b") 


@ Type the following statement, and then 
press (@ijcuy, to display the contents of wt. 


wt 


Python displays the string '1 cwt equals 
112 lb.'. 


CHAPTER 
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eco ™ Code — Python — 57x27 
guy@Mac-Pro-3 Code % python3 i 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "License" for more 
information. 
>>> locl = "{} is in {}." l 
>>> loc2 = locl.format("Utica", "New York State") 


] 

‘Utica is in New York State.' 

>>> ml = "{2} {1} equals {0} {3}." 

>>> m2 = ml.format("1/16", "hammer", 1, *ro0t") <Q ] 
] 


‘1 hammer equals 1/16 foot.' 
>>> ff 


eee ™ Code — Python — 57x27 
guy@Mac-Pro-3 Code % python3 qu 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) 
[Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more 
information. 


>>> locl = "{} is in {}." ] 
>>> loc2 = locl.format("Utica", "New York State") ] 


‘Utica is in New York State.' 

>>> ml = "{2} {1} equals {0} {3}." ] 

>>> m2 = ml. format("1/16", "hammer", 1, "foot") 

>>> m2 ] 

‘1 hammer equals 1/16 foot.' 

>>> wt = "{wl} {ul} equals {w2} {u2}.".format(wl=1, w2=11 

2, ul="cwt", u2="1lb") 
wt ] 

"1 cwt equals 112 lb.' 

>>> Ef 


Is it better to use keywords than index numbers with the . format method? 
Both index numbers and keywords work fine, so use whichever you prefer. You can also mix and match 


index numbers and keywords in the same tuple if you so wish — for example, print ("Hello, {0} and 
{n2}!". format ("John", n2="Jane")) displays the string Hello, John and Jane!. 
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Build Strings with f-Strings 


a. 3.6 introduced formatted string literals, known as f-strings for short. An f-string starts with 
the letter f, either uppercase or lowercase, followed by the string’s contents inside either single 
quotes or double quotes. Inside the string, you include placeholders to indicate where to insert 
items; each placeholder contains the name of the appropriate item. You can provide the items via 


variables, from a dictionary, or from a class. 


See the subsection “Format Strings with f-Strings” in the section “Meet Python’s Tools for Building 


Strings,” 


Build Strings with f-Strings 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


(2 } Type the following statement, which creates the 
variables 01, 02, and 03 and assigns a city name 


to each. Press GqG3. 


ol, 02, 03 = "Albuquerque", 
"Bakersfield", "Cleveland" 


© Type the following statement, which uses the 
print () function to display a string containing 
the three variables inserted by name. Press (ie). 


{o2}, 


print (£"We have offices in {ol}, 
and {03}.") 


Python displays the string We have offices in 


Albuquerque, Bakersfield, and Cleveland.. 


4) Type the following statement, which creates a dictionary 
named a_dict and assigns values named France, 
Germany, Spain, and Finland to it. Press GXG@3. 


a_ dict = { 
"France": "Toulouse", 
"Germany": "Siegen", 
"Spain": "Valladolid", 
"Finland": "Rovaniemi" 
} 


@ Type the following statement, which uses the print () 


earlier in this chapter, for general information about working with f-strings. 


‘Command Prompt - python 
licrosoft Windows [Version 10.0.22000.466] 
(c¢) Microsoft Corporation. All rights reserved. 


pis \User= lau aby coo 


n 3.10.0 (rage /v3. +10.0: Be h Oct 4 2021, 19:00:18) [Msc 
929 oT bit, Amped) en on win3, 
ype » "copyright" wenedits" or "license" for more informa 


“Bakersfield”, "Cleveland™ 


ftion. 
>> 01, 02, 03 = pal buqualiguely 
>> printf" "we have offices in {01}, {02}, and {03}."). 


BH Command Prompt - python - oOo x 


licrosoft Windows [Version 10.0.22000.466] 
Ic) Microsoft Corporation. All rights reserved. | 


pscteauyepy no 
hot 


n 3.10.0 SESE +10. Oa Ag ENED Oct 4 2021, 19:00:18) [Msc 
1929 64 bit, 
ape "help", “copyright” ming es" or "license" for more informa 
eS mol, 02, 03 = "Albuquerque", “Bakersfield”, "Cleveland" 


>> print F" We have offices in fo: {02} 

le ceed in Albuquerque a d 0 acer ande 

>> adict ={ 
" "Ip 


jeg 
++ "Spain": alla solid", 
. “Fimland": “Rovaniemi 


eee q Br Coe we have associates in {a_dict["Germany"]} and asicr 
["Finland"]}.') 


function to display an f-string that includes two items from the dictionary, and then press NC): 


print (f£'We have associates in {a_dict["Germany"]} and {a_dict["Finland"]}.') 
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Python displays the resulting f-string, We have BB Command Prompt python - oO x 
Microsoft Windows [Version 10.0.22000.466] 
(c) Microsoft Corporation. All rights reserved. | 


:\Users\guy>python 
ython 3.10.0 rane ye: -10.0:b494F59, Oct 4 2021, 19:00:18) [Msc 
+1929 64 bit, AMD64)] on win32 


associates in Siegen and Rovaniemi.. 


ype "help", “copyright”, “credits” or “license” for more informa 


Note: Chapter 12, “Working with Classes,” shows you 
how to create classes and work with them. ete 02,03 = “Albuquerque”, "Bakersfield", “cleveland” 


>> print f"We have offices in {01}, {02}, an ao Be 
le have offices in Albuquerque, Bal erstialdia an eveland. 
>> a_dict = it 

"France": "Toulouse" 5 


@ Type the following statement, which creates a 


class named c1 and gives it properties named poe Tormey’ 3, Semen 
' -+» "Finland": "Rovaniemi" 
quantity, type, returnable, and status. b>> prinece ‘We have associates in {a_dict["Germany"]} and {a_dict 
i ids cain ("Finland Dy 
Press Enter | twice to end the class definition. ye have genes in Siegen and Rovaniemi. 
Ree $ auantity = 500 i 
class cl: i Bae posequnctat a) 
quantity = 500 ieee Ghee aa 
type = "nonsequential" eae 
returnable = "approval" 
status = "new" 


Note: Be sure to indent the quantity, type, 


3 a Command Mesiesd : _ ia) x 
returnable, and status lines by two spaces orien aca Re SE ICE oe 
beyond the class line. Avsers \auy=pycha 

ython 3.10.0 ‘eae (3 .10.0:b494f59, oct 4 2021, 19:00:18) [Msc 
” A +1929 64 bit, AMD64) on win32 
@ Type the following statement, which creates a yoo "help", "copyright", "credits" or "license" for more informa 
: : p = "Al , "Bakersfield", "Cleveland" 
variable named order1 and assigns to it an f- Scr eckema nade bvguraue (ol), fort, oa a (63 Loe 
. . . le neyee oridess in Albuquerque, Bal érsfield, an eveland. 
string that incorporates two properties from the = ferance™; "toutouse", 
1 class. Pr l ror germany iF eB sam 
o1 class. Press GE Baers 
orderl = f'The order is for p> print ct Weshave associates in {a_dict["Germany"]} and {a_dict 
{cl : quantity} units in {cl . type} fe have, assaciates in Siegen and Rovaniemi. 
combinations.' ae type = *nonsequential a 
5 returnable = ‘approval" 
. . status = "new' 
8 ) Type the following statement, which uses the BSS orderl = f'The order is for {cl.quantity} units in (er.tyve) QD 
function to display the contents of p print corders) 
print () unctio Pp y e@ order is for 500 units in nonsequential combinations. 
order1, and then press (ey: 


print (order1) 


Can I create an f-string on multiple lines of code? 
Yes, you can create an f-string on multiple lines. You must start each line with an £, as in the following 
example: 
dy, dt, mth = "Wednesday", 24, "June" 
>>> d ( 
£'Today is {dy}. ' 
f'The date is {mth} {dt}.' 


This produces the f-string Today is Wednesday. The date is June 24.. 
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Build Strings with Template Strings 


f you need to build strings that include text that the user inputs, you can use template strings 
rather than f-strings. A template string is a string that contains one or more placeholders into 
which you insert strings by using a mapping object. Template strings are more secure than f-strings, 
because the use of placeholders prevents users from entering a formatted string designed to access 


variables within your code and export data from them. 


See the subsection “Format Strings with Template Strings” in the section “Meet Python’s Tools for 
Building Strings,” earlier in this chapter, for general information about template strings. 


Launch Python and Import the Template 
Class 


@ Open a terminal window and launch Python. 


© The Python prompt appears. 


@ Type the following statement, which imports the 
Template class from the string library, and 


then press GG3: 


from string import Template 


Note: The word Template requires the capital 7. 
Using lowercase template returns an ImportError 
error. 


The Python prompt appears again, but Python 
gives no other response indicating that it has 
imported the Template class. 


3 ) Type the following statement, which creates 
a variable named temp1 and assigns to it an 
instance of the Template class containing the 
string in the format you want the input to have. 


Press GSD. 


temp1 = Template('Location: $where') 


@ Iype the following statement, which uses the 
print () function to display the result of using 


the substitute () method to prompt the user to 


enter the office location. Press G9. 
print (temp1.substitute (where=input 


('Type the office location: ')) 
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eee Text — Python — 66x26 
guy@Mac-Pro-2 Text % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 


jon. 
>>> from string import renptatehe@) 


eee ™ Text — Python — 66x26 
guy@Mac-Pro-2 Text % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 
jon. 


i) 


>>> from string import Template 

>>> temp1 = Template('Location: $where' 

>>> print(temp1.substitute(where = input('Type the office location 
PD DD) | 
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Python displays the prompt: 
Type the office location: 


5) Type the location, and then press (Se). 


Python displays the resulting string, such as Location: 
Sacramento. 


6 ) Type the following statement, which creates a variable 
named temp2 and assigns to it an instance of the 
Template class containing the string in the format you 
want the input to have. Press 3@3. 


temp2 = Template('Status: ${dn}denominational') 


Note: See the tip for details about including {} in a template 
string. 


7 ) Type the following statement, which creates a variable 
named s5 and assigns to it the template string resulting 
from using the substitute() method to prompt the user 
to enter the denomination type. Press GG). 


s5 = temp2.substitute(dn = input ('Type 
"non"/"extra"/"intra" to specify the 
denomination type: ')) 


Python displays the prompt: 
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Working with Text 


eo0oe 1 Text — Python — 66x26 


guy@Mac-Pro-2 Text % python3 I 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 
jon. 

>>> from string import Template ] 
>>> temp1 = Template('Location: $where') ] 
>>> print(temp1.substitute(where = input('Type the office location] 
*'))) 

Type the office location: Sacramento 1 
Location: Sacramento 

>>> temp2 = Template('Status: ${dn}denominational! I 
>>> s5 = temp2.substitute(dn = input('Type "non"/"extra"/"intra" tl 
© specify the denomination type: ')) 

>>> 


eo50e 1 Text —-zsh— 66x26 
guy@Mac-Pro-2 Text % python3 iF 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 
jon. 

>>> from string import Template ] 
>>> templ = Template('Location: $where') ] 
>>> print(templ.substitute(where = input('Type the office location! 
ee) D) 

Type the office location: Sacramento ] 
Location: Sacramento 

>>> temp2 = Template('Status: ${dn}denominational') 1 
>>> s5 = temp2.substitute(dn = input('Type "non"/"extra"/"intra" t] 


© specify the denomination type: ')) 
Type "non"/"extralupibintra" to specify the denomination type: extr: 


>>> print(ss ] 
Status: extradenominational 


>>> 


Type "non"/"extra"/"intra" to specify the denomination type: 


© Type non, extra, or intra, and then press GIG. 


9 ) Type the following statement, which uses the print () function to display s5, and then press qe: 


print (s5) 


Python displays the string, such as Status: extradenominational. 


TIP 


Why do template strings sometimes use {} as well as $? 


Template strings use the dollar sign, $, to indicate a placeholder in the string. For example, Template ('Sitem 
is wet') .substitute(item="Water") uses § as a placeholder marking where to insert item in the string, 
returning Water is wet. But when the placeholder is not demarcated by a space or punctuation character, 


a template string needs {} to demarcate it. For example, Template ('$xshine is hot').substitute 
(x="Sun") returns a KeyError error on xshine, because Python cannot pick out x from xshine. In such 
cases, you use {} to demarcate the placeholder — for example, Template ('${x}shine is hot'). 
substitute (x="sun") returns Sunshine is hot. 


0005377500.INDD 217 Trim size: 7.375 in x 9.25 in 


217 


July 1, 2022 9:29 PM 


0005377501.INDD 218 


errorsS 


®@ errors6 xX 


Users > guy > Dropbox > TYV_Python > Code > Errors 
1 adrFile = ire 
2 adrs=[] 
3. tty: 
4 f = open(adrFile,'r') 
5 try: 
6 for line in f.readlines(): 
7 currAdr=[] 
8 for field in line.strip( ).split( ): 
9 currAdr.append( field) 
10 adrs.append(currAdr) 
pf except: 
12 print("Ar r oc I 
13. except FileNotFoundError: 
14 print(f i {adrFile} t ) 
15 except: 
16 print("An ert I t 
17. else: 
18 f.close() 
19 print(adrs) 
na 1 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE 


guy@fac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Errors/e 
rrorsS 

The file ‘addresses.csv' was not found. 

guy@Mac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Errors/e 
rrorsS 

[['Random Associates', ' 44 Main', ' Bakersfield’, ' CA'], ['Returnable Envelope Cor 
p.', ' 1699 Lincoln’, ' Phoenix', ' AZ']] 

guy@ac-Pro-3 ~ % [] 


Ln 20,Col5 Spaces:4 UTF-8 LF Python 


Trim size: 7.375 in x 9.25 in 


3.10.0 64-bit 


Od 6 


b y 
') 
) 
+ A xX 
>| zsh guy 


DB) Python guy 


® 0 
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Raise an Exception Manually .............. 
Add an else Block ora finally Block ........ 
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Create Custom Exceptions 
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Understanding the Various Types of Errors 


n this section, you learn about the different types of errors that can occur in code, what causes 
them, and what you can do to eliminate them. 


We start with compile-time errors, errors that occur when Python is unable to create workable 
instructions from the commands in a script. Many compile-time errors are syntax errors, mistakes 
in the structure of the code. We then move on to runtime errors, errors that occur after Python has 
compiled a script successfully and has moved on to executing it. Runtime errors include semantic 
errors and logical errors. 


Compile-Time Errors 


Python is generally considered an interpreted language, which is often understood to mean that it is not a 
compiled language. But the difference between interpreted computing languages and compiled computing 
languages is not clear cut, and Python does perform compilation. 


Before running a script, Python compiles it to a form called byte code, interpreting the commands the script 
contains and creating from them instructions that the computer can execute. The instructions need to be 
specific to the computer's operating system, such as Windows or macOS, and to the processor type, such as 
Intel or Apple Silicon. 


A compile-time error occurs when the script’s commands are incomplete, incorrect, or otherwise will not 
work. A compile-time error occurs before the script runs, so Python does not run the script. You need to fix 
the problem in order to make the script run. 


Runtime Errors 

After compiling the code in the script, Python tells the computer to run the script. At this point, you may 
get a runtime error — an error that occurs while the code is running, as opposed to while the code is being 
compiled. 


A runtime error may manifest itself as an exception that stops the script from running and causes Python to 
display an error message. Alternatively, the script may freeze or crash, it may return an unexpected result, 
or it may damage data. 


Syntax Errors 


A syntax error, also called a syntactical error, is an error where the problem lies in the structure of the code 
statements. Syntax errors have various causes, including the following: 


Straightforward typos, such as the wrong character, missing punctuation, or an extra space 

Missing required elements of a statement 

Extra, and incorrect, elements of a statement 

Confusion about variables, such as unintentionally creating the new variable firstname when you mean 
to reassign the existing variable firstName 
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Python itself or your code editor may be able to identify a syntax >>> a = ["Ann", "BiLL",, "Chris"] 
error for you. For example, the illustration shows Python flagging Ra eee dein) Meee 
the cause of a syntax error in the following statement, which eer: 

6 : 0 . SyntaxError: invalid syntax 
contains an extra comma after the "Bil1" item in the list. The >> ff 
caret (A) points to the problem, and the SyntaxError statement 


(B) briefly explains what is wrong. 


a= wan sya LIL Mi Claas] 


Semantic Errors 


A semantic error is an error in which your code is syntactically correct but does not execute the way you 
intend it to. The word semantic means “related to meaning in language or logic” — in other words, the 
meaning of the code is wrong. 


For example, if a script gets stuck in an infinite loop because the break statement you included never gets 
triggered, you have likely committed a semantic error. Similarly, if a wnile loop never runs because its 
condition cannot be met, that might be a semantic error. 


Your code editor or IDE will typically not catch semantic errors. Instead, you will normally discover them 
while testing and debugging your scripts. 


How you discover semantic errors will vary depending on the error’s effects. Continuing the previous 
example, you will notice an infinite loop quickly, because the script will not finish and you will need to 
break out of the loop. By contrast, a while loop that never runs may be less obvious. 


Logical Errors 


A logical error occurs when you, the developer, have told the script to take the wrong action. Even though 
the script is syntactically correct and semantically correct, what the script does is incorrect. For example, a 
logical error might occur if you make a mistake with operator precedence when performing calculations or if 
you use integer division where you should use floating-point division. 
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Identify Common Python Errors 


ython includes a wide variety of built-in exceptions for handling types of errors that occur 

frequently. For example, a SyntaxError error occurs when Python's parser encounters syntax it 
cannot convert into valid code, such as when you omit a comma or include an extra parenthesis. A 
TypeError error occurs when the code specifies the wrong type of object for an operation, such as 
trying to add an integer and a string. A ValueError error occurs when the code specifies the correct 
type of object but an incorrect value, such as trying to return the square root of a negative number. 


Table 10-1 explains common error types in Python. 


Table 10-1: Common Errors in Python 


Exception 


AssertionError 


AttributeError 
EOFError 
FloatingPointError 
GeneratorExit 
ImportError 
IndexError 
KeyError 
KeyboardInterrupt 
MemoryError 
ModuleNotFoundError 
NameError 


Not ImplementedError 


OSError 
OverflowError 


ReferenceError 


RuntimeError 


222 


0005377501.INDD 222 


Trim size: 7.375 in x 9.25 in 


Occurs When 


An assert statement fails. An assert statement is a tool used for debugging 
code. 


An attribute assignment or attribute reference is incorrect. 
The input () function reaches the end-of-file condition. 
An error occurs in a floating-point calculation. 

Code calls the close () method of a generator. 

Importing the specified module fails. 

The index number of a sequence is out of range. 

The specified key is not in the dictionary. 

The user gave a keyboard interrupt by pressing @%)+@ or GE). 
An operation runs out of memory. 

Python cannot find the specified module. 

The specified variable is not found. 


An abstract method requires a derived class to override the method; or a 
developer uses this error as a placeholder to show a real implementation is still 
needed. 


An operating system-related error occurs. 
An arithmetic operation returns an error too large to represent. 


A weak reference proxy accesses an attribute of an item that has been garbage 
collected. 


A runtime error occurs that does not fall into any other category. 
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Exception 
StopIteration 
SyntaxError 


IndentationError 
TabError 


SystemError 
SystemExit 

TypeError 
UnboundLocalError 
UnicodeError 
UnicodeEncodeError 
UnicodeDecodeError 
UnicodeTranslateError 


ValueError 


ZeroDivisionError 
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The next () function finds no further items in the iterator to return. 


Occurs When 


The parser encounters a syntax error. 


The indentation level of a statement is incorrect — for example, some 
indentation is missing. 


The indentation consists of a mixture of tabs and spaces instead of only tabs or 
only spaces. 


An internal error occurs in the Python interpreter. 

The sys.exit() method runs. 

An object is of the wrong type for the specified operation. 

A function or method refers to a local variable that has no value. 
Encoding or decoding Unicode characters causes an error. 
Encoding Unicode characters causes an error. 

Decoding Unicode characters causes an error. 

A Unicode-related error occurs during translation. 


An argument passed to a function or method has the correct type but an 
incorrect value. 


Division or modulo by zero is attempted. 
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Meet the try... except Block 


ython uses a type of object called an exception to handle errors. Python includes many built-in 

exceptions, which are all derived from the same base class of exception. For example, using the 
wrong name may cause a NameException exception, whereas supplying the wrong kind of value 
may cause a ValueException exception. 


When an error occurs, Python raises or throws an exception. You can catch or trap an exception so 
that you can determine what has gone wrong and do something about it. 


Python’s tool for handling exceptions is the try... except block, which looks like the 
following pseudocode. Italics indicate placeholders, and the sections in brackets are optional. 
eaves 
statements1 
[except error: 
statements2] 
exXGepir 
statements3 
[else: 
statements4] 
[finally: 
statements5] 


Here is how the try... except block works: 


try:. This keyword starts the try block. 

statements1. This block contains one or more statements that may cause an exception. The try 
block is said to wrap these statements. 

except error:. The except keyword starts an except block for the specified error. For example, 
except NameError: starts an except block that controls what happens when a NameError error 
occurs. 

statementsz2. This block contains one or more statements to run when the specified error 

occurs. 

except:. The except keyword without a specific error starts an except block for any error. 
statements3. This block contains one or more statements to run when any error occurs. 

else:. The else keyword starts a block specifying what to do if no error has occurred. 
statements4. This block contains one or more statements to run if no error has occurred. 
finally:. This keyword starts a block specifying what to do after the rest of the try... 

except block has completed, whether an error has occurred or not. 

statementss. This block contains one or more statements to run after execution reaches the final - 
ly keyword. 


The following subsections contain brief examples of try... except blocks. 
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Trap Any Exception 


If you just want to trap any exception that Python try: 
raises, you can use a plain except statement, as in 5/0 


the following example: Beers 
print ("An error occurred.") 


Trap One or More Particular Exceptions 


A generic error message offers little help, so you will except (ZeroDivisionError) :. This block 

often do better to trap one or more specific exceptions catches ZeroDivisionError, the error that oc- 

that are likely to occur, as in the following example: curs when your code tries to divide by zero. As the 
code stands, the x = 5/0 statement triggers a 

5/0 ZeroDivisionError error. 

except (NameError) : © except:. This block catches any other errors. 


int ("A issing." ve 
ee | areas The unqualified except block must be the last 
except (ZeroDivisionError) : 


print ("A divide-by-zero error except statement in the try... except block. 
occurred.") You cannot use except with a specific error after an 
except: unqualified except block. Doing so causes the error 

print ("An error occurred.") SyntaxError: default 'except:' must be 
last. 


Nears 


This example contains three except blocks: 


® except (NameError) :. This block catches 
NameError, the type of error that occurs when 
your code specifies an item that does not exist. 


Add an else Block 


Python supports adding an else block toatry... print ("An error occurred.") 
except block. Here is an example: else: 
print ("No error occurred.") 
5/0 An else block can be useful, but many try... 
except: except blocks do not need one. 


Add a finally Block 


You can include a finally block in your try... (Eee 
except blocks to specify an action that Python 5/0 
should always perform, whether or not an exception °*C°Pt: 


: print ("An error occurred.") 
has occurred. Here is an example: ; 
finally: 


print ("The try block has finished.") 
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Cause Errors and Trap Exceptions 


n this section, you cause errors in your code deliberately and observe the exceptions that Python 

throws as a result. You then handle the exceptions by using try... except blocks. The first 
try... except block you create is generic, returning the same error message for every exception it 
catches. After that, you create a more sophisticated try... except block that displays specific error 
messages for the exceptions you raised earlier, plus a generic error message for any other exception. 


Cause Errors and Trap Exceptions 


Cause Errors and Create a Generic Exception ccc = ona a 
Last login: Mon Apr 4 18:22:49 on conso iu 
Trap |guy@Mac-Pro-3 ~ % python3 ] 
a 7 Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20 
@ Open a terminal window and launch Python. ) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
Type "help", "copyright", "credits" or "license" for mor 


@ The Python prompt appears. "A lees > | | 


Traceback (most recent call last): 


@ lype the following statement, which creates the File "<stdin>", Line 1, in <module> 
. . . wae ZeroDivisionError: division by zero) 
variable x and assigns to it the result of 5 divided >>> x = y 
by 0. Press GIS. 
x = 5/0 
An error occurs. 
© Python displays the exception for the error: 
ZeroDivisionError: division by zero 
Type the following statement, which assigns to x 
the value of variable y, and then press (T@¥9. [ | 
x = y eco ~ guy — Python — 56x27 
Last login: Mon APE: 4 18:22:49 on console a 
= |guy@Mac-Pro-3 ~ % python3 ] 
An error occurs, because y does not yet exist. Python 3.10.0 ee 10.0:b494f5935c, Oct 4 2021, 14:59:20 
. r ) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 
@ Python displays the exception for the error: Type help?) Teopyrienet; Neredita® on "itcense! ‘for or 
e information. 
NameError: name 'y' is not defined Een: 
(most recent call last): 
7 ri File "<stdin>", line 1, in <module> 
@ Type the following try... except block, which ZeroDivisionError: division by zero 
. “ce . [>>> = 
uses a single unspecified exception. Press Gey) Traceback (aust «recent ‘coll “Last)t 
at the end of each line, and press (IG again at NaneError: name ty! is not defined <Q) 
the end [>>> try: 
a‘ (Case x = 5/0 | 
[... except: i} 
try: (Genes "An error occurred. "a@ ] 
= (apart ] 
ee 5/0 "An i occurred. “aff 
except: >>> 


"An error occurred." 


@ Python returns 'An error occurred. ' because 
the try block catches the error. 
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Trap Specific Errors eco guy — Python — 56x27 


Type "help", "copyright", "credits" or "License" for mor 5 


‘ ‘ ‘ inf ion. 
@ In the same terminal window, type the following try... Sees 
. . oad Traceback (most recent call last): 
except block, which includes specific messages for the File "<stdin>", line 1, in <module> 
Bok 7 . . ZeroDivisionError: division by zero 
ZeroDivisionError exception and the NameError exception p> key 
i 5 A Traceback (most recent call last): 
you raised earlier. Press (iy at the end of each line. File "<stdin>", Line 1, in <module> 
NameError: name 'y' is not defined 
>>> try: 
bry? Phe x = 5/0 
x = 5/0 He ne error occurred." 
except (ZeroDivisionError) : sae aren tuers ate 
"A divide-by-zero error occurred." har ee 5/9 
except (NameError) : a except (ZeroDivisionError): 
- " < ret "A divide-by-zero error occurred. aD 
"A name is missing. " ++. except (NameError): 
bee "A name is missing." ] 
except: «+. except: ] 


"An error occurred." ] 


"An error occurred." 


iAldivide=by=zero error occurred. af 
@ Press GSI to end the block. a __ 


eco guy — Python — 56x27 


@ Python returns the message 'A divide-by-zero error >>> try: - 


x = 5/0 
occurred.', because except (Zero Game nccP GE 


"An error occurred." 
DivisionError) catches the error. 


"An error occurred.' 


>>> try: 
© Type the same try... except block, but this time include Be ee Te a ceaeecang: 
x = y to produce the NameError exception. Press Gay at i ae 
. wee "A name is missing." 
the end of each line. Ptexcect: 


"An error occurred." 


try: ‘A divide-by-zero error occurred.' 
aS a sa =y 
except (ZeroDivisionError) : |... except(ZeroDivisionError): 
; ‘ att "A divide-by-zero error occurred. “QED 
"A divide-by-zero error occurred." +++ except(NameError): 
oon "A name is missing." 
except (NameError) : te. except: 


if ' . . " "An error occurred." 
A name is missing. 


except 5 = is missing. =F] 


"An error occurred." 


@ Press GTS to end the block. 


@ Python returns the message 'A name is missing.', 
because the except (NameError) catches the error. 


How many except statements can I include in a Can I use a try block without an 
try... except block? except block? 
You can have pretty much as many except statements as No. Each try block must be part of a 


you need, as long as only the last of them is the except try... except block that includes at least 
statement with no arguments. Each of the earlier except one except block. However, you can enter 
statements must have an argument, such as pass as the sole statement in the except 
except (NameError) or Except (ZeroDivisionError). block to have the block exist but do nothing. 
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Raise an Exception Manually 


ii the previous section, “Cause Errors and Trap Exceptions,” you caused the ZeroDivisionError 
and NameError errors deliberately by entering statements guaranteed not to work. This approach 
is straightforward for some errors, but you might need to get creative to produce other errors. So 
Python offers an alternative: You can raise specific exceptions manually to test your code. 


To raise an exception, you use the raise command and specify the type of exception — for 
example, raise Exception or raise RuntimeError. You can also specify the text to display to 


the user when the exception or error is raised. 


Raise an Exception Manually 


Raise an Exception Outside of atry... except 
Block 


@ Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ Iype the following statement, which uses the raise 
keyword to raise a ValueError error with a custom 


message. Press @uco. 
raise ValueError("This value is not valid.") 
@ Python returns the following: 


Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
ValueError: This value is not valid. 


Raise an Exception Inside of atry... except Block 


@ Still in the same terminal window and Python session, type 
the following try block, which contains a statement that 
raises a TypeError. Press (je) at the end of each line. 


try: 
raise TypeError 


@ Type the following except block, which catches the 
TypeError exception. Press (Qj at the end of each line, 
and then press (@{@j again to end the block. 


except TypeError: 
print ("A TypeError exception has 
occurred.") 


@ Python displays the resulting message: 


A TypeError exception has occurred. 
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eco ™ guy — Python — 56x27 

guy@Mac-Pro-3 ~ % python3 & 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20 
) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "License" for mor 
e information. 


>> raise ValueError("This value is not ae 2 ) 
Traceback (most recent call last): 

File "<stdin>", Line 1, in <module> 
ValueError: This value is not SB ) 


>>> & 


ec0e © guy — Python — 56x27 

guy@Mac-Pro-3 ~ % python3 = 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20 
) [Clang 12.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for mor 
e information. 


>>> raise ValueError("This value is not valid.") 
Traceback (most recent call last): 

File "<stdin>", Line 1, in <module> 
ValueError: This value is not valid. 


>>> try: 
tats raise et 1) 
++. except TypeError: 


print("A TypeError exception has occurred.") 


A TypeError exception has occurres <Q) 
>>> ff 
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ou can add an else block toatry... except block to execute statements when no exception 

has occurred. You can also add a finally block containing statements that you want to execute 
when the try... except block has finished running, whether or not any exception arises. This 
section shows a finally block that displays information, but the block can be useful for performing 
cleanup operations, such as closing files. 


Add an else Block or a finally Block 


© Open a terminal window and launch eco guy = Python = 62525 Zz 
P th n guy@Mac-Pro-3 ~ % python3 ie 
y on. Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Cla 
: . ng 12.0.5 (clang-1205.0.22.11)] on darwin 
e Type the following try block, which Type "help", "copyright", "credits" or "license" for more info 
creates the variable n and assigns Qe: 
51 to it; creates the variable d and tee n= 51 
‘ ‘ a a aaa d = int(input("Enter the integer divisor: ")) 
assigns the user's input divisor, cast nee msg = str(n) + " divided by " + str(d) + " equals " + 
str(n/d) 


to an integer; and creates the variable ae : 
. . » except ZeroDivisionError: 
msg and assigns a message to it. see msg = "You cannot divide by zero."p 


try: 


d = int (input ("Enter the 
integer divisor: ")) 


msg = str(n) + " divided 
by " + str(d) + " equals " + 
str (n/d) 


: eee guy — Python — 62x25 
© Type the following except block to © pace Kylie = 
handle a potential zeroDivisionError Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Cla 
ti . ng 12.0.5 (clang-1205.0.22.11)] on darwin 
exception: Type "help", "copyright", "credits" or "license" for more info 
eee rmation. 
except ZeroDivisionError: >>> try: 
eee n= 51 
msg = "You cannot divide Mears d = int(input("Enter the integer divisor: ")) 
" bean msg = str(n) + " divided by " + str(d) + " equals " + 
by zero. serin/a) 
. : ts +». except ZeroDivisionError: 
Type the following finally block, which ag msg = "You cannot divide by zero." 
H a - finally: 
displays the contents of msg: See 
finally: Enter the integer divisor: 4 
; 51 divided by 4 equals 12.75 
print (msg) >>> | 


@ Press G59 again to end the block. 
6] Type an integer at the prompt. 


@ The result appears. 
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Create Nested try... except Blocks 


ython enables you to nest try... except blocks inside other try... except blocks. Nesting 
blocks enables you to perform more complex error handling. 


If an exception is raised in the outer try... except block, the outer block handles the exception. 
If the inner try... except block raises an exception, the inner block handles the exception; if it 
fails to do so — for example, because it has no unqualified except statement — the outer block 
takes over responsibility for handling the exception. 


Create Nested try... except Blocks 


e Open Visual Studio Code and create a new Python script. 


errors: 1 ooOG o 


x 
jsers } guy > Dropbox > TYV_Pythan > Code > Errors 5 
adrFile = “addresses. csv's 
adrs=[] 
try: 4 
f = open(adrFile, 'r* 
| 


Type the following statement, which creates a variable 
called adrFile and assigns to it the file addresses. 


csv. Press GG. 


adrFile = "addresses.csv" 


3 ) Type the following statement, which creates a variable named 
addresses and assigns to it an empty list. Press GC. 


adrs = [] 


@ ype the following try block, which uses the open () 
function to open addressFile in Read Mode. Press G@NG3. 


ood 


try: eo0e 
£ = open("adrFile", "r") ieciays Ooeer teeters sree 


adrFile = “addresses.csv" 


At the same level of indentation, type the nested try block, 
which uses two for loops to iterate through the lines in £, 


1 

2 

3 tf 

4 f = open(adrFile, 'r') 

5 try: 

6 for line in f.readlines(): 
7 

8 


. a . currAdr=[] 
split the addresses at the commas, and assign the resulting é tor co 5 | 
fields to the adrs list. Press 9 at the end of each line. | ae , 
12 print("An error occurred in the inner try... except block.” 
B 
Pry: 


for line in f.readlines(): 
currAdr= [] 
for field in line.strip('\n'). 
split(','): 
currAdr.append (field) 
adrs.append (currAdr) 


6 ) Indented to the level of the inner try block, type the inner 
except block, which uses the print () function to display 
an error message. Press ly at the end of each line. 


except: 
print ("An error occurred in the inner 
try... except block.") 
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7 ) Press twice to remove the indent, and an 


@ errors5 x 


then type the following except block, which runs Sasha den eis Picea 
if the FileNotFoundError occurs. Press Gicy at noni 


the end of each line. aida al 
for line in f.readlines(): 
currAdr=[] 


except FileNotFoundError: Oe east er Rais 
or field in line.strip('\n').split(','): 
print (f£"The file '{adrFile}' was currades append (field) 


adrs.append(currAdr) 


not found." ) except: 


print("An error occurred in the inner try... except block.") 


. ‘ except FileNotFoundError: 
8 ) Press to remove the indent again, and print(f"The file '{adrFile}' was not tous." QD 


except: 


then type the following unqualified except block, | pranetias error occurred in the outer try... except block." 
pressing (@@9 at the end of each line. 


except: 
print ("An error occurred in the 
outer try... except block.") 


Ln17,Col5 Spaces:4 UTF-8 LF Python 3.10.0 64-bit 


9 ) Press (=Els/=-F(-.)) to remove the indent once more, —_ sen o> ~<) 
and then type the following else block, which Users > guy? Dropbox > TYV_Pyhon > Code > Errors > # eres 
2 1 adrFile = “addresses.csv" 
2 adrs=(] 
closes £ and displays the addresses. Press iG) at a ais 
the end of each line. S| eee 
5 try: 
6 : for line in f.readlines(): 
else: 7 currAdr=[] 
8 for field in line.strip('\n').split(','): 
£.close ( ) 9 currAdr.append( field) 
1 10 adrs.append(currAdr) 4 
print (adrs ) 11 except: 
12 print("An error occurred in the inner try... except block.") 
. . . . 13 except FileNotFoundError: 
(10) Click Run Python Fi le in Terminal (Pp). 14 print(f"The file '{adrFile}' was not found.") 
15 ts 
a 16 aes error occurred in the outer try... except block.") 
The Terminal pane appears. 17 else: 
18 f.close() 
2 19 printers) QD 
A FileNotFoundError occurs, because cad alan -Saae ola $oax 
= juy@tlac-Pro-3 ~ % /usr/Local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Errors/e [3] zsh guy 
addres s € s © c sv does not ex] st. rer ‘addresses.csv' was not fae i ° ame guy 
-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Errors/e 
The except FileNotFoundError: block beget neg Peet apy ne” | 1s CBee emi <Q 


Col Spaces:4 UTF-8 3.10.0 64-bit 


F Python 


catches the exception. 


@ The error message appears. @ Click Run Python File in Terminal (>). 


11) Create a file named addresses.csv containing @ The address information appears. 
address information in the folder Python is using. 
Put each address on one line, with commas 
separating the fields. 


TIP 


Can I have multiple levels of nested try... except blocks? 


Yes, Python enables you to nest try... except blocks multiple layers deep. But your code is likely to 
become confusing, especially to others. 
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Create Custom Exceptions 


s you have seen earlier in this chapter, Python includes a wide range of built-in exceptions. But 
Python also lets you create your own custom exceptions, which enables you to track exactly what 
is going wrong in your code. 


To create custom exceptions, you create a class based on Python’s base class of exceptions. You can then 
use a raise statement to raise instances of the exception, assigning a custom error message to make 
clear the problem to the user. See Chapter 12, “Working with Classes,” for more information on classes. 


Create Custom Exceptions 


@ Open Visual Studio Code and create a new Python eee 1) none 
scripe. eg ee rer aay eas 

(2 } Type the following class header, which creates 4 : ae 
a class named InvalidTitle based on the s Co 


Exception object. 
class InvalidTitle (Exception) : 

3 ) Type the pass keyword as the only statement for 
the class, allowing the code to run without 


taking any action. Press (jG twice, creating a 
blank line. 


pass 


4 ) Press to delete the indent, and then 
type the start of a try block. Press G@qGp. 


iC: ry: ® errors_21 x 
© ype the following statement, which creates a aiid aie 
variable named title and assigns to it the = 
result of the input () function prompting eee ee »& 
the user to enter the title. Press Enter } = InvalidTitle("The title is entirely numeric.") 


title = input ("Type the title: ") 


6 ) Type the following if block, which uses the 
isnumeric() method to check whether 
title is entirely numeric and, if so, raises an 
InvalidTitle instance with a custom error 
message. Press (ig at the end of each line. 


if title.isnumeric(): 
raise InvalidTitle("The title is 
entirely numeric.") 
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@ Press to remove one step of indentation, and 


then type the following two elif blocks, which use the 
len() function to check the length of title and raise 
InvalidTitle instances if it is too short or too long: 
elif len(title) < 5: 

raise InvalidTitle("The title is too 
short.") 
elif len(title) > 50: 

raise InvalidTitle("The title is too 
long.") 

8 ) Press once, and then type the following two 
elif blocks, which raise InvalidTitle instances for 
all uppercase and all lowercase: 
elif title.isupper(): 

raise InvalidTitle("The title is all 
uppercase.") 
elif title.islower(): 

raise InvalidTitle("The title is all 
lowercase.") 


9 ) Press twice to remove the indentation, and 
then type the following except statement, which casts 
an InvalidTitle exception to IT and prints that 
object: 


except InvalidTitle as IT: 
print (IT) 


Press once to remove the indent, and then 
type the following if block, which displays title 
if no exception has been raised: 


else: 
print (title) 


@ Click Run Python File in Terminal ([>). 


The Terminal pane appears. 


How should I test the custom exceptions further? 


CHAPTER 


Handling Errors 10 


errors_2 
® errors_21 x 
Users > guy > Dropbox > TYV_Python > Code > Errors > @ errors_2 
1 class InvalidTitle(Exception): 
pass 


title = input("Type the title: ") 
if title. isnumeric(): 
raise InvalidTitle("The title is entirely numeric.") 


elif len(title) <5: 
raise InvalidTitle("The title is too short.") 
elif len(title) > 50: 


raise InvalidTitle("The title is too long.") 


elif title. isupper(): 
raise InvalidTitle("The title is all uppercase.") 


elif title. islower(): 
raise InvalidTitle("The title is all lowercase.") 


ara 11 


Users > guy > Dropbox > TYV_Python > Code > Errors > @ errors_2 
1 class InvalidTitle(Exception): 
2 pass 


3 

4 : 

5 title = input("Type the title: ") 

6 if title.isnumeric(): 

7 raise InvalidTitle("The title is entirely numeric.") 
8 elif len(title) <5: 


9 raise InvalidTitle("The title is too short.") 

10 elif len(title) > 50: 4 
11 raise InvalidTitle("The title is too long.") 

12 elif title. isupper(): 

13 raise InvalidTitle("The title is all uppercase.") 

14 elif title. islower(): 


15 raise InvalidTitle("Th le is all lowercase.") 
16 except InvalidTitle as 9) 

17 print(IT) 

18 else: 

19 | occ 10) 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE te nx 


guy@ttac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Errors/ BJ zsh guy 
errors 2 

Type the title: 44A By Python auy 
The title is too short 

guy@tiac-Pro-3 ~ ff 


© When prompted, type a title. 
@ If the title provokes an exception, the 


relevant message appears. 


Click Run Python File in Terminal ([>) again, and then type a title designed to raise one of the errors. For 


example, type a title that is all numbers, all uppercase, or all lowercase. Alternatively, type a title that has 
fewer than 4 characters or more than 50 characters. 
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CHAPTER 11 


Working with 
Lists and 
Dictionaries 


Python provides lists and dictionaries for storing data efficiently in variables. 
A list is a collection that can store multiple items of the same type or of 
different types and provides access to its items via an index. A dictionary 

is similar to a list but more powerful, allowing you to create collections of 
information that you access through named elements called keys. 
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Understanding Lists and Their Use 


I Python, a list is an object that enables you to store multiple items within a single variable. The 
items can be of the same type or of different types. The list contains an index that enables you to 
set or retrieve the individual items. Technically, a list is a mutable sequence, so you can change the 
order of its items, add and remove items, sort the items, and so on. 


A List Is Ordered and Indexed 
In Python, a list is an ordered and indexed collection: 


e Ordered. The items in a list appear in the order you set. You can change the order by adding items, 
removing items, or reversing the order. 


Indexed. The list items are indexed using zero-based numbering, so the first list item is item 0, the sec- 
ond item is item 1, and so on. You use the index numbers to access the list items. 


List Items Are Mutable 


The items in a list are mutable, so you can change a list after creating it. For example, you can add items to 
a list, remove items from it, or reverse its order. 


Lists Can Contain Duplicate Values 


A list can contain duplicate values, as there is no constraint requiring each value to be unique. 


You can use the count () method to count the number of items in a list that have a particular value. 


Understanding How Lists Compare to Tuples and Sets 
Table 11-1 summarizes the three key attributes of lists, tuples, and sets in Python. 


Table 11-1: Attributes of Lists, Tuples, and Sets 


Collection Mutable Ordered Duplicates Allowed 
List Yes Yes Yes 
Set Yes No No 


Tuple No Yes Yes 
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Understanding How Lists Compare to Sets 

In Python, both a list and a set can contain various types of data, which gives you great flexibility at the 
risk of occasionally running into the wrong data type for your needs. Beyond that, however, lists differ 
significantly from sets. 


First, a list is ordered, while a set is unordered. Second, a list can contain duplicates, whereas a set cannot 
contain duplicates. Third, and more technically, Python sets use hashing to store their values, which makes 
lookups in sets fast and efficient but means the order of a set’s items may vary. 


Understanding How Lists Compare to Tuples 

The key difference between a list and a tuple is that a list is mutable whereas a tuple is immutable. Both 
lists and tuples are ordered and can contain duplicate items. Both lists and tuples are sequential, which 
enables you to iterate through the items they contain. 


Tuples’ immutability means that they are more memory efficient than lists and require less processing time. 
When your code contains data that will not need to be changed, you may be able to improve performance by 
using tuples rather than lists. 


Understanding How Python Lists Compare to Arrays in Other Programming Languages 


Python lists are similar to arrays in other programming languages, but lists offer greater flexibility. There are 
two main differences between lists and arrays. 


First, when you create an array, you specify its data type, such as float; the array can contain only items 
that have that data type. By contrast, a list in Python can contain items of different data types, as needed. 


Second, when you create an array, you specify the number of items it contains. Python allocates memory to 
store each potential item, but you do not need to populate each item immediately, or indeed ever. By 
contrast, a list’s size is dynamic, increasing as items are added, but each item must contain data, even if 
the data type is None. 
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Create a List 


T; create a list, you declare a variable; enter the assignment operator, =; and then enter the list 
items, separated by commas, within square brackets. For example, the statement list1 = [1, 
2, 3] declares a variable named 1ist1 and assigns to it three integers — 1, 2, and 3. 


In this section, you create three lists in a terminal window. The first list contains integers, the 
second list contains strings, and the third list contains four different data types. 


Create a List 


& Open a terminal window and launch Python. 
@ The Python prompt appears. 


@ Type the following statement, which creates a 
variable named 1list1 and assigns five integers 
to it, and then press 3S: 


listl. = [ly 2) 3, 4, 5] 


© Type the following statement, which uses the 
print () function to display the contents of 
list1, and then press G@NG3: 


print (list1) 


Python displays [1, 2, 3, 4, 5]. The 
brackets indicate that the variable’s contents are 
a list. 


@ Type the following statement, which creates a 
variable named list2 and assigns two strings 
to it, and then press (E33: 


list2 = ["Evie", "Frank"] 


© Type the following statement, which creates a 
variable named 1ist3 and assigns several kinds 
of data to it. Press GG. 


list3 = [11.5, "cats", True, 0] 


@ Type the following statement to display the 
contents of list2. Press Gq. 


print (list2) 


Python displays ['Evie', 'Frank']. 
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@>- ‘Command Prompt - python - oO xX 
ficrosoft Windows [Version 10.0.22000.466] 


((c¢) Microsoft Corporation. All rights reserved. | 


eAusens \euyzpy con 

ea 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 
Cv.1929 64 bit CAMD64) ] on win32 

[Type "help", “copyright”, “credits” or "license" for more i 


cimsti one 
>> lis ae ee 
>> LE eRTeb) 

(1, 2, 3, 4, 5] 

p>> 


BH Command Prompt - o x 


Microsoft Windows [Version 10.0.22000.466] 
l(c) Microsoft Corporation. All rights reserved. | 


Pst AUsatS \CuyeR YEG 

m3 200 age 8 20 10. iS] on wink Oct 4 2021, 19:00:18) 
hype. “help” » "copyright", "credits" or "license" for more i 
ormation. 
bos Visthacit 25735 4505) 
>> aiielo heres 1) 


Bt Q 
+3 fist = ic tvie" , Frank 
>> listS = [11.5, “cats, ae 0} 
rint(list2) 
Evie', ‘Frank we 7) 


>> print(list3) 
11.5, "cats", True, 0] 


@ Type the following statement to display the 
contents of list3. Press Ge. 


print (list3) 


Python displays [11.5, 'cats', 
True, 0]. 
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CHAPTER 


Meet Python’s List Methods 11 


ython provides 11 methods for working with lists. Three of these methods — append (), 

extend(), and insert () — enable you to add items to the list. Conversely, three other 
methods — clear(), pop(), and remove () — enable you to remove one or all methods from the 
list. The other five methods enable you to sort the list, return an element by its position in the list, 
return the number of items that match specific criteria, and create a copy of the list. 


Table 11-2 explains Python’s methods for working with lists. 


Table 11-2: Methods for Working with Lists 


Method Use This Method To 

append () Add an element to the end of the list. 

clear () Remove all the elements from the list. 

copy () Create a copy of the list. 

count Count the number of list elements that match the specified value. 

) Extend the list by adding the elements from another list or other iterable. 
Return the index number of the first list element that matches the specified value. 

) Insert an element in the list at the specified index position. 

pop () Remove the list element at the specified index position. 

remove () Remove the first list element that matches the specified value. 

reverse () Reverse the order of the whole list. 


( 
extend 
index ( 

iS 


) 
( 
) 
( 


inser 


sort () Sort the list in ascending order, descending order, or ordered by the function specified. 


The following list provides examples of using these methods. You will use the methods more 
extensively during the first half of this chapter. 


e Create a list named 1ist4 and a list named lists: 
list4 
ii st5 
Insert an item at the first index position in the list list4: 
list4.insert(0, "Abigail") 

Extend the list 1ist4 by adding the elements from lists: 
list4.extend(list5) 

Add the item Gloria to the end of the list list4: 
list4.append ("Gloria") 

Sort the list 1ist4 alphabetically: 

list4.sort () 

Remove the second item from the list list4: 
list4.pop(1) 

Remove all the items from the list list4: 
list4.clear () 


["Brian", "Charlene", "Dan"] 
[" Eva" A "Finn" ] 
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Add Items to a List 


ython’s lists are mutable, so you can change a list after creating it. Often, you will want to add 

items to the list, as explained here, or remove items from it, as explained in the following section, 
“Remove Items from a List.” You can use the append () method to add a single element to the end of 
a list, use the insert () method to insert an item at a specific index position in the list, or use the 
extend () method to extend the list by adding items from another list or from another iterable element. 


Add Items to a List 


@ Open a terminal window and launch Python. 
© The Python prompt appears. 


2] Type the following statement, which creates 
the variable ni and assigns a list of two 
strings to it. Press G9. 


nl = ["Sam", "George"] 


3] Type the following print () statement, and 
then press (2303, to display the contents of 
nas 


print (n1) 


Python displays ['Sam', 'George']. 


© [ype the following statement, which creates 
the variable n2 and assigns a list of two 
other strings to it. Press G3S3. 


n2 = ["Antonia", "Brett"] 


© ype the following print () statement, and 
then press (G33, to display the contents of 
n2: 


print (n2) 


Python displays ['Antonia', 
'Brett']. 


@ Type the following statement, which uses 
the insert () method to insert a string at 
position 1 — second — inn1. Press (egy. 


nil.insert(1, "Helen") 
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lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 


>>> print(n1) 


lsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 


sam@vubuntu: ~ 1 2d = = o 


ype "help", "copyright", "cri s" or "license" for more information. 
>> ni = ["Sam", "George" ] 


sam@vubuntu: ~ 


", "copyright", "credits" or "License" for more information. 
Sam", "George"] 
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@ Press § four times, making Python enter the : oes 
print (n1) statement again, and then press san@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
Enter J [GCC 9.3.0] on linux 
ype "help", "copyright", "credits" or "license" for more information. 
. >>> ni = ["Sam", "George"] 
print (n1) >>> print(n1) 


['Sam', 'George'] 
>>> n2 = ["Antonia", "Brett"] 


Python displays ['Sam', 'Helen', 


'George! ]. Perec) 


>>> ni.insert(1, "Helen") 


© Type the following statement, which uses 
the extend() method to add n2 to the end 
of n1, and then press (Te): 


nl.extend(n2) 


@ Press G twice to enter the print (n1) 
statement once more, and then press (qe3: 


print (n1) 


Python displays ['Sam', 'Helen', 
'George', '‘Antonia', 'Brett']. abies cts 
lsam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on linux 

ype "help", "copyright", "credits" or "license" for more information. 


€© Type the following statement, which uses the 
append () method to add a string to the end 
>>> n2 = ["Antonia", "Brett"] 


of n1, and then press (IG): 
nl.append ("Sia") Panera, perce] 


@®) Press 9 twice to enter the print (n1) 
statement yet again, and then press (Ve). 


['Sam', 'George'] 


['Sam', 'Helen', 'Georg 
>>> n1.append("Sia") 


‘Antonia’, 'Brett'] 
print (n1) 

7 hy .Brett:,, “Stary 
Python displays ['Sam', 'Helen', 
'George', 'Antonia', 'Brett', 
'Sia']. 


How do I extend a list with items from an iterable other than a list? 
Use the extend () method and specify the iterable as the argument. For example, say you type listo = 
[1, 3] and press (fe) to create a list, then type tupleo = (11, 17) and press (NG) to create a 


tuple. You can use list0.extend(tupleod) to extend listo with the items from tupleo. Typing 
print (listo) returns [1, 3, 11, 17]. Similarly, you can type seto = {7, 9, 13} and press EXGQ 
to create a set, and then type list0.extend(set0) to add the set to listo. Python adds the tuple’s 
items in the order you created them, but the order of the set’s items varies. 
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Remove Items from a List 


ython provides three methods for removing items from a list. When you need to remove a single 

item by specifying its index position, use the pop() method. When you need to remove the first 
item that matches the value you specify, use the remove () method; you may then need to check for 
other instances of the item in the list and remove them too if necessary. When you need to remove 
all the items from the list, use the clear () method. 


Tistremove py 1 


@ In Visual Studio Code, create a new script, and then save it. 


Dro Ss 
dx = [1, 3, 4, 4, 4, 5, 7, 4, 8 4, 11] 

2 print("The list contains " + str(dx.count(4)) + " instances. 
of 4.") 

3 print("Removing the 4 at index position " + str(dx.index(4)) 
“ee 

4 | 


@ ‘ype the following statement, which creates a variable 
named dx and assigns to it a list of integers. Press GG. 


dx = [1, 3, 4, 4, 4, 5, 7, 4, 8, 4, 11] 


© Type the following statement, which uses the print () 
function to display a string giving the number of instances 
of 4 in the list. Press (TE. 


print ("The list contains " + str(dx. 
count (4)) + " instances of 4.") 


4 ) Type the following statement, which uses the index () 
method to return the position of the first 4 in the dx list 
and the print () function to display a string announcing 
its removal. Press (GY). 


print ("Removing the 4 at index position " + 
str(dx.index(4)) + ".") 


Ln 4,Col1_ Spacesi4 UTF-8 LF {} Python @ 0 


Tist-remove_1.py 
% list-remove_1py x >~ oO 
Users > guy > Dropbox > TYV_Python > Code > Lists > @ list-remove_1.py 
1 dx = [1, 3, 4, 4, 4, 5, 7, 4, 8, 4, 11) 
2 print("The list contains " + str(dx.count(4)) + " instances 
of 4.") 
3 print("Removing the 4 at index position " + str(dx. index(4)) 
A") 
dx.pop(dx. index(4)) 


5 while dx.count(4) > - 6) 4 
6 print("The list contains " + str(dx.count(4)) +". 
instances of 4.") 


© Type the following statement, which uses the pop () 
method of the dx list to remove the first 4 by specifying 
its index position. Press GEG. 


dx.pop (dx. index (4) ) 


@ Type the following statement, which starts a while loop 
that runs while the count () method returns more than 
one 4 in the dx list. Press @TS3- 


while dx.count(4) > 1: 


@oA0 Ln7,Col1 Spaces UTF-8 LF (} Python 0 


@ Copy the step 4 statement and paste it onto the line after 
the while line, accepting the indent that Visual Studio 
Code automatically applies. 


print ("The list contains " + str(dx. 
count (4)) + " instances of 4.") 
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8] Type the following statement, which creates a variable 
called msg and assigns to it a string announcing the 
removal of the 4 at the index position it specifies. 


Press GS. 


msg = "Removing the 4 at index position 
"+ str(dx.index(4)) + "." 


© Type the following statement, which uses the 
remove () method to remove the first instance of 4 


from dx. Press GIG. 


dx .remove (4) 


€© Type the following statement, which uses the print () 
function to display msg. Press GG. 


print (msg) 


&® Press to remove the indent, ending the 
while block, and then type the following statement 
to display the contents of dx. Press GG. 


print (dx) 


Type the following statement, which uses the clear () 
method to remove the contents of dx. Press G9. 


dx.clear () 


@® Type the following statement to display the contents 
of dx — nothing. 


print (dx) 
@ Click Run Python File in Terminal ([>). 
The Terminal pane appears. 


@ The print () statements display the output as the 
while loop whittles down the instances of 4 until 
only one remains. 


Is there an easy way to deduplicate a list? 


0 Ln10,Col1 Spaces:4 UTF-8 LF {} Python # O 


list-remove_1.py 
® list-remove_ipy x be Os 
Users > guy > Dropbox > TYV_Python > Code > Lists > @ list-remove_1.py > 
1 dx = [1, 3, 4, 4, 4, 5, 7, 4, 8, 4, 11] 
2 print("The list contains " + str(dx.count(4)) + " instances 
of 4.") 
3. print("Removing the 4 at index position " + str(dx.index(4)) 
“") 
4  dx.pop(dx. index(4)) 
5 while dx.count(4) > 1: 
6 print("The list contains " + str(dx.count(4)) +" 


instances of 4.") 

a msg = “Removing the 4 at index position " + oe 8 | 
(ay) + 

8 axerenve se) 


9 print(msg, 
10 


list-remove_1.py 


® list-remove_t.py x 14 . 


Users > guy > Dropbox > TYV_Python > Code > Lists > @ list-remove_1.py 
1 dx =[1, 3, 4, 4, 4, 5, 7, 4, 8, 4, 11] 
2 print("The list contains " + str(dx.count(4)) + " instances 
of 4.") 
3. print("Removing the 4 at index position " + str(dx.index(4)) 
“") 
4  dx.pop(dx. index(4)) 
5 while dx.count(4) > 1: 
6 print("The list contains " + str(dx.count(4)) +" 
instances of 4.") 
7 msg = "Removing the 4 at index position " + str(dx. index 
(4)) + "." 
dx. remove(4) 
print(msg) 


print (dx) 
ete 12) 
print(dx) 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE +e ax 


guy@ttac-Pro-2 ~ % /usr/ocal/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Lists/ti BJ zsh 
st-remove_1.py Bi) Python 
The List Contains 5 instances of 4. 


Removing the 4 at index position 4. 
fi, 3,5, 7, 8, 4, 11] 


a 
guy@ac-Pro-2 ~ % ] 


Ln12,Col10 Spaces:4 UTF-8 LF 


} Python 


Yes. You can deduplicate — remove duplicate values from — a list by creating a set from the list. For example, 
you could create a list containing duplicate values by typing myList = [1, 1, 2, 2, 3, 3] and pressing 


(2N@3. You could then type mySet = set (myList) and press (2G to create a set called mySet containing 
{1, 2, 3}. If you want to end up with a list rather than a set, convert the set to a list — for example, type 
myList = list (mySet) and press Gey to get a list called myList containing [1, 2, 3]. 
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Locate Items and Access Data in a List 


ften, you will need to determine whether a list contains a particular item and, if it does, where 

that item is. Python provides the count () method and the index() method to take care of 
this need. You use the count () method to return an integer value giving the number of elements 
in the list that match a specified value. If this number is greater than 0, you can use the index () 
method to return the index number of the first item in the list that matches your specified value. 


@ Open a terminal window and launch Python. — pfs ommsronr re —o x 
IC: \Users\guy>pythor | 
The Python prompt appears. Python 3.10.0 3-10,0:b494f59, oct 4 2021, 19:00:18 
ap he Eyton plombe dpe PAB ats et a0e/v3,20,01b4o4tS9, oc ) 
< A ‘ype "help" » "copyright", *eredits” or “license” for more i 
@ Iype the following statement, which Oo. 
2 p>> scores = [20, 15, 40, 48, 15, 8] 
creates a variable named scores and b>> print (len(scores)) 


assigns to it a list containing several 
integers. Press GG. 
scores = [20, 15, 40, 48, 15, 8] 


©} Type the following statement, which 
uses the len() function to return the 
number of items in the scores List. 


Press GS. 


print (len(scores) ) 


Python displays 6, the number of items. BB Command Prompt - python =o x 
F a eS U | 
4) Type the following statement, which uses the ‘ mE iytu fay 10.0:b494F59, oct 4 2021, 19:00:18) 
i MSC Vv. 1929 64 bit CAMD64)] on win32 
count () method to determine the number [Tye "help", “copyright”, “credits” or “license” for more i 
: : Information 
of instances of 15 in scores, and then b>> scores = [20, 40, 48, 15, 8] 
Ee peaneClancecaran}) 
press | Enter § >>> scores .count (15) <Q) 
(15) e scores index (15) EY 
scores.count b>> 5 


Python returns 2, because the scores list 
contains two instances of 15. 


@© Type the following statement, which uses 
the index () method to return the index 
position of the first instance of 15 in the list. 


Press GS. 


scores.index (15) 
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Python returns 1, indicating that the first instance 
of 15 is at index position 1 in the list — in other 
words, it is the second item. 


© Type the following statement, which uses the 
count () method to determine the number of 
instances of 36 in scores, and then press GE: 


scores.count (36) 


Python displays 0, because the scores list 
contains no instances of 36. 


@ Type the following statement, which uses the 
index () method to return the index position of 
the first instance of 36 in the list. Press GG. 


scores. index (36) 


© Python returns an error: ValueError: 36 is 
not in list. 


How can I determine the number of unique values in a list? 
Create a set containing the contents of the list, and then use the 1en() function to return the number of items 


a Command Prompt - python - Oo x 


Ic: \Users\guy>python | 
eee 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 
MSC v.1929 64 bit (AMD64)] on win32 q 
|Type "help", “copyright”, “credits” or "license" for more i 
Information. 
>> scores = [20 15, 40, 48, 15, 8] 
Age print(len scores)) 
Bre scores.count(15) 
bP>> scores.index(15) 


1 
ee scores .count ce<Q 


p>> 


IBM Command Prompt - a x 


Ic: \Users\guy>python | 

Python 3.10.0 (tags/v3.10.0:b494F59, Oct 4 2021, 19:00:18) 
MSC v.1929 64 bit (AMD64)] on win32 

|Type "help", “copyright", “credits” or “license” for more i 

Information. 

>> scores = {20; 15, 40, 48, 15, 8] 

a print(len(scores)) 

Eee scores.count(15) 


ees scores.index(15) 
Bae scores .count (36) 
>> scores. index(36 


raceback (most recent call last): 
File "<stdin>", line 1, in <module> 


\ValueError: 36 is not in list 
bs 0 


in the set. For example, if you create the scores list as explained in the main text, you can type a statement 


such as my_set = 


from scores. You can then type print (len (my set) ) 


set (scores) and press (jj to create a set name my_set containing the unique values 


to display the number of items in my set. 
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Sort the Items ina List 


ython provides two methods for sorting the items in a list. The reverse () method simply 

reverses the current sort order of the list, so if you have a list named names1 that contains 
["Alex", "Blake", "Cody"), namesl.reverse() returns ["Cody", "Blake", "Alex"]. 
The sort () method is more widely useful, enabling you to sort a list in ascending order, in 
descending order, or in the order given by a function you specify. 


Sort the Items in a List 


Sort Using the sort () Method and the 
reverse () Method 


@ Open a terminal window and launch Python. 


pat sam@vubuntu: ~ 1 2 


isam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


ype "help", "copyright", "credits" or "U se" for more information. 
>> k7 = ["tomato", "avocado", "okra" 


@ The Python prompt appears. 


@ Type the following statement, which creates a 
variable named k7 and assigns a list of three 
fruits to it. Press GS3. 


k7 = ["tomato", "avocado", "okra"] 


© Type the following statement, which sorts the 
k7 list into ascending order, and then press 


[Enter § 
k7.sort () 


@ Type the following statement, which displays 
the contents of k7, and then press (ey): 


print (k7) 


sam@vubuntu: ~ 


am@vubuntu:~$ python3 


Python displays [ 1 avocado! : lokra! , Python 3.8.10 (default, Nov 26 2021, 20:14:08) 


'tomato']. 


", "copyright", "credits" or "license" for more information. 
", "avocado", "okra"] 


@ Type the following statement, which use the 
reverse argument to sort the k7 list in 
descending order, and then press (N03: 


', 'tomato'] 
>>> k7.sort(reverse = True) 


', 'okra', ‘avocado'] 
k7.sort (reverse = True) 


@ Press @ twice to repeat the 
print (k7) statement, and then press GG): 


print (k7) 


Python displays ['tomato', 'okra', 
'avocado']. 
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@ Type the following statement, which uses the : Soni: 
reverse () method to reverse the list’s order, and ; 


then press (G9: 


k7.reverse () 


8] Press |) twice to repeat the print (k7) 
statement again, and then press (@ucw. 


>>> 


print (k7) 


Python displays ['avocado', ‘okra', 
'tomato'] again. 


Sort Using a Function That Provides 
Sort Criteria 


© Type the following function, which implements a : rnin 
crude sort by the last character of the input. Press fanevubun 
(2353 at the end of each line, and then again to ype “neta”, "copy ghe", sereduta” or “Ucense" for more tnfornaton. 
end the function and create a blank line. ; ; 


def sort_by _last(n): 
return n[-1] 


', 'okra', 'tomato'] 


Note: Indent the second line by four spaces. beset sort_by.tast(n) 
oe return n[-1 
@ Type the following statement, which creates a ellen pes Sree ee gett 
variable named animals and assigns a list of hers teog'c teat? > 3) 
three animals to it. Press G@noo. 
animals = ["cat", "dog", "snake"] 


© Type the following statement, which uses the 


sort () method to sort the animals list by the @ Type a print () statement to display the 
sort by last function. Press Guoy. contents of animals, and then press GG): 
animals.sort (key=sort_by_last) print (animals) 


Python displays ['snake', 'dog', 
'cat'], the terms sorted by their last letters. 


TIP 


Can the sort () method sort items of different types? 
The sort () method can sort different types of numeric items successfully. For example, say you type x15 = 
[0, -1, False, True, 1.2] and press (ej to create a list named x15, you can then type x15. 


sort () to sort the list, even though it contains three types of values: int, bool, and float. Sorting the 
list in ascending order returns [-1, 0, False, True, 1], because Boolean False has the value o and 
Boolean True has the value 1. However, if you add a string to the list, the sort () method returns a 
TypeError error, because Python cannot compare the string with the numeric values. 
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Understanding Dictionaries and Their Use 


n Python, a dictionary is an object that enables you to store collections of data. The items in the 
dictionary consist of key/value pairs, in which a key enables you to access the corresponding value — 
similar in concept to a conventional dictionary, in which you look up a term to find its meaning. 


Technically, a dictionary is an ordered, mutable sequence, so you can add items, remove specific 
items, or simply delete the entire contents of the dictionary. 


Understanding What Python Dictionaries Are 


In Python, a dictionary is an ordered, mutable collection that cannot have duplicates: 


Ordered. The items in a dictionary have a specific order, which Python maintains. 
Mutable. A dictionary is mutable, so you can change its contents. For example, you can add items to the 


dictionary or remove items from it. 


No duplicates. Each key in the dictionary must be unique so that you can identify each key unambigu- 
ously. However, the values assigned to the keys can contain duplicates. 


Understanding the Layout of a Python Dictionary 

To create a dictionary, you enter its key/value pairs within braces, {}. Usually, you assign the entire 
dictionary to a variable so that you can refer to it easily. For example, the following statement creates a 
variable named dogo and assigns to it a dictionary consisting of a single key/value pair, the key being 


name and the value being Spot: 


dogdO = {"name": "Spot"} 


You can create a dictionary on a single line of code, as 
in the following example, which shows a single logical 
line wrapped to multiple physical lines by the 
constraints of the book. 


"breed": 
Mheaght!=) 6), 


dogl = {"name": "Minnie", 
"Chihuahua", "weight": 5, 
"age": 6} 
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dogO = 


Assignment operator Key 


Opening brace Closing brace 


{"name": 


W iol wey } 
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Normally, however, it is more convenient to break the dictionary over multiple lines of code, using the kind 
of layout shown in the following example: 


Variable Opening brace 


dog2 = { 
"name": "Max", | | 
"breed": "Newfoundland", dog2 = { 


Mweight™. 130, fete ur 


"height": 30, 
"age": 4 Mpreea: 
} "weight": 


"Max" ; 
"Newround land”; 
130; 


Here, each key — name, breed, and 
so on — appears on a separate line 
followed by a colon and its value, 


Nherghe™: 
[eeiele fen se) 7! 


} 


S10), 
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making the code easier to read 
quickly. | 


Closing brace 


You Access Dictionary Items by Key 


To access an item in a dictionary, you specify the item’s key. For example, to access the value for the breed 
key in the dog2 dictionary, you specify dog2 ["breed"]. 


Dictionaries Are Ordered in Python 3.7 Onward 


Python 3.7 changed dictionaries from unordered collections to ordered collections. If you are using Python 
3.6 or an earlier version, your code’s dictionaries will be unordered — that is, the items in a dictionary will 
be in an order, but that order will not be fixed. 


As long as you access your dictionary items by key, it makes little difference whether the dictionary items 
are ordered or unordered. But if you access your dictionary items by index position — for example, by 
creating a list of the dictionary’s keys and using that to determine a key’s position — you should be aware 
of the difference, because in Python 3.6 or earlier the items’ index positions are likely to change. 
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Create a Dictionary and Return Values 


hen you need to store data in a container that enables you to look up elements of the 
data quickly and easily, create a dictionary and assign it to a variable. You enter the entire 
dictionary within braces, {}, using a colon to connect each key to its value and a comma to separate 


each key/value pair from the next pair. 


You can then either display the entire dictionary — for example, to verify its contents and 
completeness — or return individual values by specifying their keys. 


e Open a terminal window and launch Python. 


© The Python prompt appears. 


2) Type the following statement, which creates 
a variable named dog3 and assigns to it a 
dictionary containing several canine attributes. 
Press (i) at the end of each line. 


dog3 = { 
"name": "Belle", 
"breed": "Rottweiler", 
"weight": 125, 
"height": 26, 
"age": 8 
} 


© Type the following statement, which uses the 
print () function to display the entire dog3 
dictionary. Press G@NCD. 


print (dog3) 


Python displays the dictionary’s keys and values 
on a single logical line, wrapped here: 


{'name': 'Belle', 'breed': 
"Rottweiler', 'weight': 125, 
‘height': 26, '‘age': 8} 


Type the following statement, which uses the 
print () function to display the breed key 
from the dog3 dictionary. Press (ay. 


print (dog3 ["breed"] ) 


Python displays Rottweiler. 
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Ges Command Prompt - python 


SG :\Users\guy>python 
[MSC v.1929 64 bit ( 


tee “help”, 
‘ormation. 

Qe dog3 = {, 
fee osname’: 

Bis) UOneed n= 

+e» "weight": 125, 
0 whed ght 26, 

age 


“copyright”, 


"Belle", 


pP>> 


| 
ython 3.10.0 (tags/v3.10.0:b494F59, Oct 4 2021, 19:00:18) 
AMD6: 


“Rottweiler” 


49] on win32 
"credits" or "license" for more i 
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[BH Command Prompt 


Ee :\Users\guy>python 


| 
ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 
[MSC v.1929 64 bit (AMD64)] on win32 


Type "help", “copyright", 
Formation. 
>> dog 3 = as 
"name" ; "Belle", 
"breed": "Rottweiler" 
"weight": q252 
+++ "height": 26, 
mre ae : 
print (dog3) 
name' “Belle : oe 
Hight’: 26, "age 
>> printtdosst"bread"]) 
Rottweiler 
>> 


= o x 


"credits" or "license" for more i 


‘Rottweiler’, ‘weight’: 125, ‘he 
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Meet Python’s Dictionary Methods 11 


ython provides 11 methods for working with dictionaries. Five of these methods — fromkeys(), 

get (), items (), keys(), and values () — enable you to retrieve information from a 
dictionary. On the other side of the coin, three methods — pop(), popitem(), and clear() — 
enable you to remove one or more entries from the dictionary. One method, update (), lets you 
insert key/value pairs. One method, setdefault (), does double duty, returning information if it is 
there and adding it if it is not. Finally, the copy () method enables you to copy an entire dictionary. 


Table 11-3 explains Python’s methods for working with dictionaries. 


Table 11-3: Methods for Working with Dictionaries 


Method Use This Method To 

clear () Remove all the key/value pairs from the dictionary. 

copy () Create a copy of the entire dictionary. 

fromkeys () Return a dictionary containing the specified keys and their values from this dictionary. 

get () Return the value of the specified key. 

items () Return a list containing a tuple for each key/value pair in the dictionary. 

keys () Return a list of the dictionary’s keys, without their values. 

pop () Remove the items whose key you have specified. 

popitem() Remove the last key/value pair inserted in the dictionary. 

setdefault() Return the value of the specified key, if it exists; if it does not exist, insert the key and 
assign it the specified value. 

update () Insert the specified key/value pairs in the dictionary. 


values () Return a list of all the dictionary’s values. 


The following list provides quick examples of using these methods. You will use the methods more 
extensively during the remainder of this chapter: 


e Return the keys from the dog3 dictionary: 
>>> dog3.keys 
dicupkeysi( name Yoreecd it weight 7 Uher ght! tage Mil) 
Insert a key/value pair, with the key id_ chip, in the dog3 dictionary: 
>>> dog3.update({"id_ chip": "yes"}) 
Return the value of the key coat, if it exists, and assign the given value if the key does not exist. In the 
first instance, the key does not exist, so Python creates it and assigns the value provided. In the second 
instance, the key exists, so Python returns the current value. 
>>> dog3.setdefault ("coat", "short") 
Velhomt! 
>>> dog3.setdefault ("coat", "long") 
VSlhi@imten! 
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Create a Dictionary from an Existing Iterable 


pyr fromkeys () method enables you to create a dictionary whose keys come from an existing 
iterable, such as a list, a set, or another dictionary. This way of creating a dictionary is convenient 
when you have an iterable that contains the data required for the keys in a new dictionary you want to 
create. The fromkeys () method lets you either assign the same value to each of the key/value pairs 

or not assign a value, leaving the values blank until you populate them otherwise. 


@ Open a terminal window and launch Qt a =o x 
Python. :\Users\guy>python | 

ython 3.10.0 (tags/v3.10.0:b494f59, Oct 4 2021, 19:00:18) 
(MSc v.1929 64 bit (AMD64)] on win32 

@ The Python prompt appears. Eyes she lb™ "copyright", “credits” or "license" for more i 
ormation. 

: ‘ >>> pet_factor = ["space", "character", "cost", "interactive 
@ ype the following statement, which & fev 


creates a variable named pet_factor and 
assigns to it a list of factors to consider 
when choosing a pet. Press G3. 


pet_factor = ["space", 
"Character", "cost", 
"interactivity"] 


© Type the following statement, 
which creates a variable named 
considerations and assigns to it a 
dictionary whose keys are derived by 
using the £romkeys() method on the 
pet factor list. Press GG). Til Conwnand Prompt pan =o x 


i ‘ = ‘ Ic: \Users\guy>python | 
pene Ndete tone Glee, Python 3:10,0 (tags/v3-20,0:b494r59, oct 4 2021, 19:00:18) 
fromkeys (pet factor) MSC v.1929 64 bit (AMD64)] on win32 

= [Type "help", “copyright", "credits" or "license" for more i 


: : Information. 
4) Type the following statement, which pee ree pnccen = ["space", "character", "cost", "interactiv 
ity 
7 1 1 considerations = dict.fromkeys (pet_factor 
uses the print () function to display Chm erin considerations) ae : 
‘ ‘ space': None, ‘character’: None, ‘cost': None, ‘interacti 
the contents of considerations. toa hes 
Press GG. faa = 


print (considerations) 


Python displays {'space': None, 
'character': None, 'cost': 
None, 'interactivity': 
None}. 


Note: Each key contains the value None 
because the fromkeys () method in 
step 3 did not assign a value to the keys. 
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© Type the following statement, which creates a Bi Conena ome =o x 
: a : ‘a : h 
variable named pet_prce and assigns to it a list Python. 3,90:67 {tage /v3.10,o:pasersa, oct 4 2021, 19:00:28) | 
of benefits of having a pet. Press (jap. hype whet", Rconveienetecr iran eae an “ieancal scriascet 
pet _pros = ["companionship " bes pet factor = ["space", "character", "cost", "“interactiv 
r 7 ’ a considerations = dict.fromkeys(pet_factor) 
"affection", "exercise", "memory", >> print (considerations) ; 
echedule") Seether: ‘character’: None, ‘cost’: None, ‘interacti 
>> pet_pros = ["companionship", “affection", “exercise”, ‘“~<&@ 
7 . emory", "“schedule"] 
@© Type the following statement, which creates a = cat'= dict.fromkeys(pet_pros, True 


variable called cat and assigns to it a dictionary 
whose keys are derived by using the fromkeys () 
method on the pet_pros list. The statement 
assigns a default value of True to each key. 


Press GS. 


cat = dict.fromkeys (pet _pros, True) 


@ Type the following print () statement to display I ConmandPronet =o x 
the contents of cat, and then press [Enter } Eetyaens Sy yc tries ya 40-0: 640489, Oct 4 2021, 19:00:18) 


MSC v.1929 64 bit (AMD64)] on win32 


. " om woe Set "4 "¢£ A 

print (cat) voomatielp copyright credits" or "license iis veilige: 
tt ama ets = ["space", "character", "cost", "interactiv 

. . fi 

Python displays { 'companionship': True, b> cope ae eee I ig Goi lal 
>> print(considerations 

'affection': True, ‘exercise’: space: ve ‘character’: None, ‘cost’: None, ‘interacti 
uM y : lone " . tnt " 2 " " . 

True, 'memory' : True, ‘schedule! : a eh aed a , "affection", “exercise”, 
>> cat = dict.fromkeys(pet_pros, True) 

True } . print (cat) 

companions hipigs UC Aas True, ‘exercise’: True 

; 'memory': True, ‘sche : 

You can now change the values of the keys, p>> 

as needed. 


How do I use the copy () method with a dictionary? 

Create a variable, and then use the copy() method to assign a copy of the dictionary to it. For example, if 
the variable myD contains a dictionary, you can use a statement such as newD = myD.copy() to create a 
new variable and copy the dictionary to it. The copy contains copies of the references from the original 
dictionary. Changes you make to the copy do not affect the original dictionary. 


You can also use the assignment operator to copy a dictionary — for example, newD = myD. This approach 
creates a new reference to the original dictionary. Changes you make to the new dictionary, such as clearing 
its contents, affect the original dictionary. 
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Add Key/Value Pairs to a Dictionary 


hen you need to add one or more key/value pairs to a dictionary, use the update () method. 

You can either add the key/value pairs by providing their information directly or add them from 
an iterable object — for example, from another dictionary. The update () method places the new 
key/value pairs at the end of the dictionary. 


You can also add a key/value pair to a dictionary by using the setdefault () method. If the key/ 
value pair already exists, this method returns the current value. If the key/value pair does not exist, 
this method creates the pair and assigns the value you provide. 


@ Open a terminal window and launch Python. : Eas 


jsam@vubuntu:~$ python3 
Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
@ The Python prompt appears. fécc 9.3.0] on Linux 
ype "help", "copyright", "J |! or “license” for more information. 
>>> dog4 = {"name": "Rex" 
P>> dog4.update({"breed": "Newfoundland"} 
b>> 


@ Type the following statement, which creates a variable 
named dog4 and assigns to it a dictionary containing 
a single key/value pair. Press (Q@9. 


dog4 = {"name": "Rex"} 


© Type the following statement, which uses the 
update () method to add one key/value pair to 


dog4, and then press (G3: 
dog4.update({"breed": "Newfoundland" }) 


@ Type the following print () statement, and then 
press GG: 


print (dog4) 


", “credits” or "License" for more information. 


Newfoundland"}) 


b ': ‘Newfoundland '} 
": 5, "color": "black"} 


Python displays {'name': 'Rex', 'breed': 098. upda 
"Newfoundland ' }. pen tats = Ceighes Fy Renee apy ee EOS ee 
© Type the following update () statement, which adds 
two more key/value pairs, and then press (N39: 
dog4.update({"age": 5, "color": "black"}) 


@ Press Gj twice to enter the print () statement again, 
and then press (@e%3: 
print (dog4) 


@ Type the following statement, which 


Python displays {'name': 'Rex', 'breed': creates a variable named stats and 
'Newfoundland', 'age': 5, 'color': assigns it a dictionary containing two 
'black'}}. key/value pairs. Press GnOo. 


stats = {"height": 28, 
"weight": 146} 
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8) Type the following statement, which uses the 
update () method to insert the key/value pairs 
from stats into dog4. Press GY. 


dog4 .update (stats) 


9) Press ©) thrice to enter the print () 
statement again, and then press qe): 


print (dog4) 


Python displays {'name': 'Rex', 
'breed': 'Newfoundland', ‘'age': 
5, 'color': 'black', 'height': 


28, 'weight': 146}. 


10) Type the following statement, which uses the 
setdefault () method to return the value 
of the breed key, if it exists, and to create the 
key/value pair if it does not. Press G@e9. 


dog4.setdefault ("breed") 


Python returns 'Newfoundland', because the 
breed key does exist. 


11) Type the following statement, which uses the 
setdefault () method to return the value of 
the temperament key, if it exists, and to create 
the key/value pair if it does not. Press (TE). 


dog4.setdefault ("temperament", 
"amiable") 


Python returns 'amiable', which tells you that 
the temperament key’s value is amiable. 


@ Type the following print () statement, which 
displays the temperament key’s value, and then 


press GTS: 


print (dog4 ["temperament"] ) 


Python displays amiable. 
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sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 

Type "help", "copyright", "credits" or "license" for more information. 
>>> dog4 = {"name": "Rex"} 
>>> dog4.update({"breed": "Newfoundland"}) 
>>> print(dog4) 
{'name': 'Rex', 'breed': 'Newfoundland'} 

>>> dog4.update({"age": 5, "color": "black"}) 


, 'breed': 'Newfoundland', ‘age': 
= {"height": 28 eight": 146} 
>>> dog4.update(stats) 


5, 'color': 'black'} 


: 'Rex', 'breed': 'Newfoundland', 'age': 5, 
: 28, 'weight': 146} 
>>> dog4.setdefault( "breed" ). 


‘colon: “black”. * 


sam@vubuntu: ~ 


Isam@vubuntu:~$ python3 

Python 3.8.10 (default, Nov 26 2021, 20:14:08) 
[GCC 9.3.0] on Linux 

Type "help", "copyright", "credits" or "license" for more information. 
>>> dog4 = {"name": "Rex"} 
>>> dog4.update({"breed": "Newfoundland"}) 
>>> print(dog4) 

{'name': 'Rex', 'breed': 'Newfoundland'} 

>>> dog4.update({"age": 5, "color": "black"}) 


: 'Rex', 'breed': 'Newfoundland', 'age': 5, 'color': 'black'} 
= {"height": 28, "weight": 146} 

>>> dog4.update(stats) 

>>> print(dog4) 

: 'Rex', 'breed': 'Newfoundland', 'age': 5, 'color': 'black', ' 
: 28, 'weight': 146} 

>>> dog4.setdefault("breed") 

‘Newfoundland’ 


>>> dog4.setdefault("temperament", "amiable" 11) 


"temperament" ] 12) 


What happens if I use the update() method for a key that exists? 


If the key already exists, Python updates it with the new value you supplied. 
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Remove Key/Value Pairs from a Dictionary 


pytren provides three methods that enable you to remove key/value pairs from a dictionary. First, 
you can use the pop() method to remove an item by specifying its key. Second, you can use the 
popitem() method to remove the last key/value pair that was added to the dictionary; because 
Python places the newest key at the end of the dictionary, this method removes the last key and 
its value. Finally, you can use the clear() method to remove all keys and their values from the 


dictionary, leaving the dictionary empty. 


1) Open a terminal window and launch Python. 


© The Python prompt appears. 


@ lype the following statement, which creates 
a variable named ocelot and assigns to 
it a dictionary containing eight key/value 


pairs. Press fey. 


ocelot = { 
"Kingdom": "Animalia", 
"Phylum": "Chordata", 
"Class": "Mammalia", 
"Order": "Carnivora", 
"Suborder": "Feliformia", 
"Family": "Felidae", 
"Subfamily": "Felinae", 
"Genus": "Leopardus" 
} 


© Type the following statement, which uses the 
popitem() method to remove the last 


key/value pair. Press (Te). 


ocelot .popitem() 


Python displays ('Genus', 'Leopardus') 
to indicate that it has removed the Genus key, 
whose value was Leopardus. 


Note: In Python versions 3.6 and earlier, the 
popitem() method removes a random key/value 
pair from the dictionary rather than the last pair. 


@ ype the following statement, which uses the 
popitem() method again but this time assigns the 
resulting tuple to a variable named y. Press GNC. 
y = ocelot .popitem() 
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jon. 
>» ocelot = { 
|... "Kingdom": "Animalia", 


eee guy — Python — 66x29 

|guy@Mac-Pro-2 ~ % python3 

Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 


E 


. "Phylum": "Chordata", 
. "Class": "Mammalia", 


| 

J 
( | 
(Se J 
[... "Order": "Carnivora", ] 
|... "Suborder": "Feli fornia" Gy J 
[... "Family": "Felidae", ] 
{ ] 
{ ] 
( ] 


- "Subfamily": "Felinae", 


. "Genus": "Leopardus" 
Bye 
>> | 
ec50oe © guy — Python — 66x29 
guy@Mac-Pro-2 ~ % python3 iu 


Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 

2.0.5 (clang-1205.0.22.11)] on darwin 

Type "help", "copyright", "credits" or "license" for more informat 

jon. 

>>> ocelot = { ] 
«. "Kingdom": "Animalia", ] 
- "Phylum": "Chordata", ] 
- "Class": "Mammalia", ] 
-» "Order": "Carnivora", ] 
.» "Suborder": "Feliformia", } 
. "Family": "Felidae", ] 
. "Subfamily": "Felinae", ] 
- "Genus": "Leopardus" ] 

eerie ] 

>>> ocelot.popitem(). ] 

('Genus', 'Leopardus') 

>>> y = ocelot.popitem() ] 

>>> | 
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© Type the following print () statement to SEES ae re : 
A guy@Mac-Pro-2 ~ % python 
display the contents of y. Press Enter § Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 1 
2.0.5 (clang-1205.0.22.11)] on darwin 
é Type "help", " ight", "credits" or "Li " ¢ jnformat 
print (y) one elp copyr ig! creaits”" or icense or more informa 
>>> ocelot = { 
1 ' 1 ' ++. "Kingdom": "Animalia", 
Python displays ('Subfamily', eee 
'Felinae'! ) . +++ "Class": "Mammalia", 
» "Order": "Carnivora", 
‘ ‘ ... "Suborder": "Feliformia", 
@ Type the following statement, which uses the Tl wpamily": "Felidae", 
ate " bf. il Ws " li a; 
pop () method to remove the Class key, and ere aires aad 
E sea 
then press Enter >>> ocelot.popitem() 
('Genus', 'Leopardus') 
ocelot . pop ("Class") >>> y = ocelot.popitem() 
Qe 
. i i Ge ('Subfamily', 'Felinae') 
Python displays 'Mammalia' to indicate >>> ocelot pop( "class" 
< é ' lia! 
the value that was assigned to the key it has 23> prine(ocetor@D 
removed. 


@ Type the following print () statement to 
display the contents of the ocelot dictionary 


as they now stand. Press (2323. [eee ry 
Python 3.10.0 (v3.10.0:b494f5935c, Oct 4 2021, 14:59:20) [Clang 18 
print (ocelot) 2.0.5 (clang-1205.0.22.11)] on darwin 


Type "help", "copyright", "credits" or "license" for more informat 
jon. 


Python displays {'Kingdom': 'Animalia', >>> ocelot = { 


«+. "Kingdom": "Animalia", 
' Phylum' : 'Chordata' 7 'Order': see "Phylum": "Chordata", 
; «+. "Class": "Mammalia", 
'Carnivora', '! Suborder': .+. "Order": "Carnivora", 
' ' ' : ++» "Suborder": "Felif ia", 
‘Pelitomiiat; ‘Family's “Pelidae'), ieq seas 
«.. "Subfamily": "Felinae", 
© Type the following statement, which uses the Screeners, Hyaeperaie? 
clear () method to remove the dictionary’s >>> ocelot. popiten() 
('Genus', 'Leopardus') 
contents, and then press (rey). >>> y = ocelot. popitem() 


>>> print(y) 
('Subfamily', 'Felinae') 


ocelot.clear () >>> ocelot.pop("Class") 
‘Mammalia! 
‘ . >>> print(ocelot) 
© Press twice to enter the print () statement {'Kingdom': 'Animalia', 'Phylum': 'Chordata', 'Order': 'Carnivora' 
7 . » 'Suborder': 'Felifompea', 'Family': 'Felidae'} 
again, and then press GG): eee, 
5 >>> print(ocelot). 
print (ocelot) {} 
>>> 


Python displays {}, indicating that the dictionary 
is empty. 


TIP 


What happens if I use the pop() method on a key that does not exist? 


If the key does not exist, the pop () method causes Python to throw a KeyError error. The error includes 
the name of the missing key so you can easily identify the problem. 
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Return Keys and Values from a Dictionary 


Ve can return a value from a dictionary by entering the corresponding key’s name in brackets after 
the dictionary’s name — for example, dog1 ["breed"] returns the value of the breed key in the 


dictionary called dog1. Alternatively, you can use the get () 


You can use the keys () 
return all its values, or use the items () 


method to return all of a dictionary’s keys, use the values () 
method to return both the keys and the values. These three 


method to return the value for a specific key. 


method to 


methods return views that update automatically when the dictionary’s contents change. 


e Open a terminal window and launch Python. 


© The Python prompt appears. 


@ Jype the following statement to create a variable 
called dogs and assign to it a dictionary 
containing a canine’s key attributes. Press (03. 


dog5 = { 
... "name": "Hondje", 
"breed": "Boerboel", 


"height": 24, 
"weight": 70 


} 


©} Type the following statement, which uses the 
get () method to return the value of the 
breed key. Press (TG). 


dog5.get ("breed") 
Python returns 'Boerboel'. 


@ lype the following statement, which uses the 
keys () method and displays all the keys in the 
dog5 dictionary, and then press (TG: 


print (dog5.keys() ) 


Python displays dict _keys(['name', 
'breed', 'height', 'weight']). 
Note: The keys () method returns a list containing 


the keys. Similarly, the values () method returns a 
list containing the values. 


258 


0005377502.INDD 258 Trim size: 7.375 in x 9.25 in 


ormation. 
Qe dog5 = 
++» "name" 


Qpe ore - oOo © 


Evenetis Seon cena | 
hon 3.10.0 (tags/v3. a 0: easiest Oct 4 2021, 19:00:18) 

tse, v.1929 64 bit (AM 64)] on 

Type "help", Scopyrianen 3 *eredits" oa "license" for more i 


: "Hondje", 
moo “breed”: “Boerboel" <i) 
. "height": 2h: 
: eer ae 


pP>> 


Command Prompt - python - ia) x 


Ee suaers \quizpycho | 

Pyne on 3.10.0 (tags /v3.1 10.0:b494f59, Oct 4 2021, 19:00:18) 
MSC Vv. 1929 64 bit (AMD D64)] on win32 

Type "help", "copyright", "credits" or "license" for more i 

Formation. 

>> dog5 = 


“Hondje", 
ke A “Boerboel", 


335 dogs. qgetc "breed" 3) 
“Boerboe 

pane dogs . keys ( ) 
ee ['name', reed’, 
>> 


‘height’, ‘weight']) 
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5] Type the following statement, which uses the BBE Command Prompt python - a x 
values () method and displays all the values in E:\users\guyspython 
oP is _ tse. v.i998 64 est, Cained pipe eau re 4 2021, 19:00:18) 
the dog5 dictionary, and then press [Enter 5 hype "help", “copyright”, “credits” or “license” for more i 
ormation. 
print (dog5.values() ) ee “nae: ‘suondie", 
.». "breed": "Boerboel", 
Python displays dict_ values (['Hondje', ee sheight:: 23, 
'"Boerboel'! j 24 ; 70] ) . bss fog get ("breed") 
“Boerboel' 


>> print (dogs . keys (op) 
ict_keys ie name', ‘breed', ‘height’, ‘weight']) 
lo. 


@ Type the following statement, which creates a 
variable named g and assigns to it the result 
of using the items () method on the dog5 


dictionary. Press G83. 
q = dog5.items() 


fict_values(['Hondje', ‘Boerboel', 24, 70]) 
>> q = dogS.items( 
>> 


Note: The items () method returns a list of tuples, 
each containing a key/value pair. 


7) Type the following statement, which uses the BBE Command Prompt =--21Bs 2X 
. : . R 
print () function to display the contents of q. E sano’ $ $0." Sage /y3.20.0 vaste, ot Goin cactus 
Press Gis. ere "help" 5 ccopyrdonen 5 ee or “license” for more i 
. ffernation. 
print (q)  erkeet: vhondjar: 
. Eeeral wbreed™: “Boerboel", 
Python displays dict _items([('name', bee seeterets so. 
'Hondje'), ('breed', 'Boerboel'), b> Sos: get "breed") 
(theight', 24), ('weight', 70)]) S55 print (008 Keys 0)) 
A jexthaye gt! name' — "height', 'weight']) 
>> print Ofuce 


He 
ict, evaluesh: feet 5 2 earboal® 7 24, .20]) 
>> q = dogS.items( 
print(q) 
ict_items te name', ‘Hondje'), (‘breed', ‘Boerboel'), (‘he 
light', 24), C'weight', 70)]) 
>> 1 


TIP 


What does it mean that keys (), values(), and items () return view objects? 

Using the keys () method, the values() method, or the items () method returns a view object, an 
object that gives you a view of the current data inside the dictionary. For example, say you execute the 
statement dogé = {"name": "Rover"}, creating a dictionary named dogé with one key/value pair. If 


you then execute the statement n = dog6.items(),n contains dict_items([('name', 
'Rover')]). But if you then execute the statement dogé ["name"] = "Spot", changing the value of 
the name key in the dictionary, n now contains dict_items([('name', 'Spot')]), because the view 
gives you the current data from the dictionary. 
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CHAPTER 12 


Working with 
Classes 


In this chapter, you work with Python’s classes, which enable you to create 
custom objects in your scripts. You learn to create a class, create objects 
based on that class, and work with those objects. Because of the nature of 
classes, this chapter is set up as an extended example using Visual Studio 
Code rather than terminal windows, and we recommend you work through 
the chapter from start to end. 


class6 


@ class6 2 x 
Users > guy > Dropbox > TYV_Python > Code > Classes > @ class6 > % BranchOffice > @ cm2cf 
class BranchOffice(): 
company = "CheeseWheat Associates" 
sector = "food science" 
@classmethod 
def showClassInfo(self): 
ci = self.company +", a" 
ci = ci + self.sector + " trendsetter" 
return ci 
__init__(self, city, street, state, zip, manager): 
self.city = city 
self.street = street 
self.state = state 
self.zip = zip 
self.manager = manager 
def getInfo(self): 
br = ( 
f"{self.city} Office\n\n" 
f"Manager: {self.manager}\n\n" 
f"{self.street}\n" 
f"{self.city}, {self.state} {self.zip}" 
) 
return br 
@staticmethod 
def cm2cf(m3): 


as BranchOffice("Arcata", "442 Front", "CA", "95221-1111", “Aurora 
Smith") 
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Understanding Classes and Instances 


L Python, a class is a template for creating objects of a particular type — a “class” of object, 

in computer terms. When you need to create standardized objects of the same type, you can 
declare a class for that type of object. You can then create what are called instances of the class — 
individual objects based on the class. 


In this chapter, you create a class called BranchOffice to use for creating objects that store data 
on the individual branch offices of a notional company. After creating the class, you can create a 
separate instance for each branch office. 


When Should You Create a Class? 
Consider creating a class when you need to create consistent objects of a type that Python itself does not 
provide. 


Classes are especially useful for encapsulation, using a single object both to store data and to provide 
functionality for manipulating that data. Creating a class makes encapsulation easy, as you can define 
attributes to store the data and construct methods to provide the necessary functionality. 


How Do You Create a Class? class Keyword Class name Colon 
You create a class by using a class header statement. The class | | 


header begins with the class keyword. Next, it provides the class BranchOffice: 
name you want to give the class. Like other headers, the class pass 
header ends with a colon, after which the statements that | 


belong to the class definition are indented by four spaces. Four spaces of pass placeholder 
indentation 


For example, the following class header creates the class called 

BranchOffice. The second statement, pass, is a placeholder indicating where code for the class will 
appear. As with other Python structures, the code for the class is indented by four spaces beyond the 
class header. 


class BranchOffice: 
pass 
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How Are Python Class Names Usually Capitalized? 


Python convention is to use a capital letter at the start of each word in the class — for example, 
BranchOf fice. This capitalization style is sometimes called Pascal Case, named after the programming 
language Pascal, which in turn was named after the French mathematician and philosopher Blaise Pascal. 


How Do You Create an Instance of BranchOf fice class Instances of BranchOf fice class 
a Class? 


After creating a class, you can create an 
instance of the class, an object based on 
the class. Creating an instance is 
sometimes referred to as instantiating 
the instance. 


To create an instance, you create a 
variable and assign an object based on 
the class. The following statement creates 
a variable named a and assigns to it an 
instance of the BranchOf fice class: 


BranchOf fice () 


The illustration shows the relationship 
between a class and instances of that 
class. 
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Create a Class and Instantiate Instances 


il this section, you create the BranchOf fice class, giving it the absolute minimum of code 
required for Python to run it without raising errors. You then create two instances of the 
BranchOf fice class, verify their class type using the type function, and compare the two 
instances to prove that they are not the same object. 


Because this chapter presents an extended example, we recommend you work in Visual Studio Code 
rather than in a terminal window. Using Visual Studio Code enables you to return easily to the code 
you have written so far and make changes to it without extensive retyping. 


Create a Class and Instantiate Instances 


@ Open Visual Studio Code and create a new —— 1) 
Python script. @ cess x Seve 
Users > guy > Dropbox > TYV_Python > Code ses > ® class 
. . 1 B hOf fice: 
@ Iype the following statement, which creates the eo" a << 
a = BranchOffice() Tl 


BranchOf fice class, and then press Gulca: 
class BranchoOffice: 


Visual Studio Code automatically indents the 
next line. 


© Type the following pass statement, which enables 
Python to run the class code without raising an 
error. Press (lew twice. 


pass 


4 ) Type the following statement, which creates a 
variable named a and assigns to it an instance of — a 
the BranchOf fice class. Press GNG9. = 


® class x Py O- 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class 
1 class BranchOffice: 
pass 


2 
3 a = BranchOffice() 
4 be Branchorricet) Gy 


print(type(a)) 


a = BranchoOffice() 


© Type the following statement, which creates 
a variable named b and assigns to it another 
instance of the BranchOf fice class. 


Press GD. 


b = BranchOffice() 


@ Iype the following statement, which uses the 
type function to retrieve the type of a and 
the print () function to display the result. 


Press GD. 


print (type (a) ) 


QAO Ln6,Col1 Spaces:4 UTF-8 LF Python 3.10.064-bit @ OQ 
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7 ) Type the following statement, which uses the 
type function to retrieve the type of b and the 
print () function to display the result. 


Press GSD. 


print (type (b) ) 


© Type the following statement, which uses the 
print () statement to display the result of 
comparing a and b. Press (uw. 


print(a == b) 
9 ) Click Run Python File in Terminal ([>). 


The Terminal pane appears. 


@ Python displays the object types of a and b. Each 
object is of the following type: 


<class ' main .BranchOffice'> 


@ Python displays False as the result of the 
a == b comparison. This indicates that a and b 
are not the same object, even though they are of 
the same object type. Similarly, if you have two 
quarters in your pocket, they are equal in that 
they have the same value, but they are separate 
coins, not the same coin. 


TIP 


CHAPTER 


Working with Classes 1 2 


oO 


® class x 
Users > guy > Dropbox > TYV_Python > Code > Classes > @ class 
class BranchOffice: 
pass 
a = BranchOffice() 
b = BranchOffice() 
print(type(a)) 
print(type(b)) 
print(a == b) 


Ln8,Col1 Spaces:4 UTF-8 LF Python 3.10.064-bit & QO 


® class x pr oO. 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class 
1 class BranchOffice: 

Pa pass 

3. a = BranchOffice() 

4  b = BranchOffice() 

5 print(type(a)) 

6 print(type(b)) 

7 print(a == b) 

8 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE 


Python - guy -+ ~ 


guy@tac-Pro-3 ~ % /usr/local/bin/python3 /Users/quy/Dropbox/TYV_Python/Code/C 
class 
<class '__main__.BranchOffice'> 


<class '__main__.BranchOffice'> 


alse 
guy@Mac-Pro-3 ~ % ff 


What does comparing the a object and the b object prove? 
Checking whether a == b — in other words, whether a is equal to b — enables you to see that these two 


objects created from the same class are not identical. If you compare a to itself — for example, 
print (a == a) — Python returns True; likewise if you compare b to itself. 
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Understanding Class and Instance Attributes 


Or you have created a class, Python enables you to set two types of attributes related 

to it: class attributes and instance attributes. In this section, you learn the difference 

between class attributes and instance attributes and how to create both types. You also learn 
about the init _() method of the class object, a special method that runs automatically when 
you create a new instance from a class, and the self keyword, which Python uses to refer in code 
to an object itself. 


Given that a class is a template that defines an object type and that an instance of a class is an object that 
uses that class as its template, you can quickly grasp the difference between class attributes and instance 
attributes. 


e Class attribute. A class attribute applies to the class as a whole, so every instance of the class has the 
same information for the attribute. Any changes you make to the attribute apply to the entire class. You 
can access a class attribute either through the class itself or through any instance of the class. 


Instance attribute. An instance attribute applies only to a particular instance of a class, not to the class 
as a whole. Any changes you make to an instance attribute are confined to that instance. You can access 
the attribute only through that instance. 


Understanding How You Set Class Attributes 

To set a class attribute, you place a statement in the class definition block. After the class header and 
indented by four spaces as usual, you create a variable for the attribute and then assign the appropriate 
data to it. 


For example, the following statements show the BranchOf fice class header followed by a statement that 
creates the variable company and assigns to it a company name. 


class BranchOffice: 
company = "CheeseWheat Associates" 
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Understanding How You Set Class header 

Instance Attributes 

To set an instance attribute, yu Class BranchOffice: 

use the init _() method of def init (self, address, manager) 
the class object. After the class 

header, and indented by four Four spaces of def _ ante G) self Instance 
spaces, place the header for the indentation keyword method name keyword attributes 

__ init _() method. The header 

consists of the def keyword, the init () name, the self parameter, and the name of each instance 
attribute you want to set. For example, the following method header provides the names address and 
manager: 


class BranchOffice: 
def init (self, address, manager): 


The self parameter refers to the current instance of the class — the instance that is being initialized by 
the init _() method. The word self is the default term for this parameter, and it is usually easiest to 
use self. However, you can use a different word instead of self if you prefer. No matter which word you 
use, you must supply it as the first parameter of any function you define in the class. 


After specifying the names of the instance attributes in the init () method header, you can set the 
values for these attributes, as in the following example: 


class BranchOffice: 
def init (self, address, manager): 
self.address = address 
self.manager = manager 
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Set Class and Instance Attributes 


i this section, you extend the BranchOf fice class by setting class attributes and instance 
attributes for it. To set the class attributes, you include statements in the class definition block. 
To set the instance attributes, you add code for the class’s_ — init _() method. The method’s name 
has two underscores before it and two after it. 


The class attributes for the BranchOf fice class are company and sector. The instance attributes 
for the instances of the BranchOf fice class are manager, street, city, state, and zip. 


Set Class and Instance Attributes 


@ In Visual Studio Code, open the script you created 
earlier. 


® class x 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class >.. 
1 class BranchOffice: 


company = "CheeseWheat Associates eG) 
sector = "food science" 7 


a = BranchOffice() 
b = BranchOffice() 
print(type(a)) 
print(type(b)) 
print(a == b) 


Double-click the pass statement in line 2 to 
select it, and then type over it the following 
statement, which creates the variable company 
and assigns to it the company name. Press Guco. 


company = "CheeseWheat Associates" 


Swormaroaw 


Note: When you replace the pass statement, make 
sure you maintain the indentation for the company 
statement. 


© Type the following statement, which creates the 
variable sector and assigns a string to it. 


Press GSD. 


sector = "food science" 


Ln4,Col9 Spaces:4 UTF-8 LF Python 3.10.064-bit & OQ 


4 Type the following statement, which uses the def 


keyword to create the init () method for the @ class x 
class. The statement gives self as the required first ea. 
argument and adds five instance attributes: city, company = “CheeseWheat Associates" 
sector = "food science" 
street, state, zip, and manager. Press Enter } def _init_(self, city, street, state, GQ 
manager): 
def init (self, city, street, seureceeyi> av—@ 
state, zip, manager) : a = BranchOffice() 
b = BranchOffice() 
Note: Type two underscores before init and two print(type(a)) 
: print(type(b)) 
after it. print(a == b) 


5) Type the following statement, which assigns to 
the city attribute of the self object the value 
passed by the city argument in the call to 
initialize the class. Press GNC. 


self.city = city 
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6 ) Type the following four statements, which 
similarly populate the street, state, zip, and 
manager attributes of the self object. Press 
(G35 at the end of each line. 


self.street = street 
self.state = state 
self.zip = zip 
self.manager = manager 


@ Click inside the parentheses of the a = 
BranchOffice() statement, and then type in 
strings for the five instance attributes. 


a = BranchOffice("Arcata", "442 Front", 
"CA", "95521-1111", "Aurora Smith") 


Note: You do not need to provide a value for the 
self attribute. 


© Repeat step 7 for the b = BranchOffice () 
statement: 


b = BranchOffice("Blythe", "6 Lincoln", 
"CA", "92225-1234", "Art Kimura") 


Select the five print () statements, and then 

type over them the five following statements, 

pressing log at the end of each line: 

print (a.manager) 

print (a.street) 

print (a.city) 

print (a.state) 

print (a.zip) 

© Click Run Python File in Terminal ([>). 
The Terminal pane opens. 


@ Python displays the information from the instance 
attributes of the a object. 


Must I assign an initial value to a class 
attribute? 


Yes, each class attribute must receive an initial 
value. But you can assign None as an initial value if 
you do not have an actual value to assign. 
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class 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class 

1 class BranchOffice: 

2 company = "CheeseWheat Associates" 

3 sector = “food science" 

4 def __init_(self, city, street, state, zip, 
manager): 

5 self.city = city 

6 self.street = street 4 

7 self.state = state 

8 self.zip = zip 

9 

t) 

1 


self.manager = nanager MQ) 
a = BranchOffice("Arcata", "442 Front", oe 7 ) 


"95521-1111", “Aurora Smith") 
12. b = BranchOffice() 
13. print(type(a)) 
14 print(type(b)) 
15 print(a == b) 
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class 
® class x 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class 
Wergue ge 


5 self.city = city 

6 self.street = street 

7 self.state = state 

8 self.zip = zip 

9 self.manager = manager 

10 

11 a = BranchOffice("Arcata", "442 Front", "CA", 


"95521-1111", “Aurora Smith") | 
12 b = BranchOffice("Blythe", "6 Lincoln", 8 } 
"92225-1234", “Art Kimura") 
13. print(a.manager) 
14 print(a.street) 
15 print(a.city) 
16 print(a.state) 
17 print(a.zip)| 


a x 


guy@fac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Classes/ 
class 

Aurora Smith 

442 Front 

Arcata 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE >] Python - guy + v 


CA 
95521-1111 
guy@Mac-Pro-3 ~ % [] 


@o0Ao Ln17,Col13 Spaces:4 UTF-8 LF Python 3.10.064-bit & Q 


How do I return a class attribute? 

Use the class name, a period, and the attribute 
name. For example, print (BranchOffice. 
company) displays the company attribute of the 
BranchOf fice Class. 
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Grasp Class, Instance, and Static Methods 


method is a unit of code that performs an action on an object. A method is similar to a function, 

but it is bound to a particular object rather than being globally available. Python enables you to 
create and use three different types of methods within a class: class methods, instance methods, and 
static methods. In this section, you learn how these three types of methods work and how they differ 
from each other. You also learn how and when to use each type of method. 


A class can contain class methods, instance methods, and static methods. You create any methods needed 
when you define the class, including the methods’ code as part of the class definition. 


Class Methods 


A class method belongs to the class object that declares it. A class method can access only data within the 
class itself, not data within any particular instance of the class. A class method can change the data in the 
class. 


You would create a class method to take action in the class, such as changing the class's state. 


Instance Methods 


An instance method belongs to a particular instance created from the class object that declares the method. 
An instance method can access data within that instance, but it cannot access data within other instances 
created from the same class object. An instance method can also access data within the class itself by using 
the self. class __ attribute. 


You would create an instance method to take action within a particular instance of the class, accessing data 
from within the class itself if necessary. 


Static Methods 


A static method is bound to the class that declares it but cannot change the data in the class; it also cannot 
access, let alone change, the data in an instance based on the class. A static method is similar to a function 
except that it belongs to the class’s namespace and becomes available only when you create the class. 


You would create a static method to add functionality that was needed only when the class or an instance 
of the class was active and that did not require access to the data of either the class or the instance. 
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Which Type of Method Should You Use in Your Classes? 


Generally speaking, instance methods are the most widely useful of the three types of methods bound to 
classes, because an instance method can manipulate data either in its own instance or in the class on which 
the instance is based. By contrast, a class method can manipulate data only in its own class; and a static 
method cannot even access data within its own class, though it can perform other actions freely. 


When you create a method inside a class definition, Python makes the method an instance method by 
default. You can change the method to a class method or an instance method if necessary. 


The following sections show you how to create and call instance methods, class methods, and static 
methods. 


Create an Instance Method 


To create an instance method, you place code inside the class definition. The first line of the instance 
method is the method head, which consists of the def keyword, the method name, parentheses containing 
the required parameter self and any other parameters, and a colon. For example, the first of the following 
statements starts the class definition, the second is a comment, and the third contains the method header 
for an instance method called getManagerName: 


class Branchoffice(): 
# the def init function appears here 
def getManagerName (self): 


After the method header, you include the statements for the method, indented by four spaces. Here is an 
example: 


class BranchOffice(): 
# the def init function appears here 
def getManagerName (self): 
mgr = £"{self.city} Office Manager: {self.manager}" 
return mgr 


Call an Instance Method 

You can call an instance method only from an instance of the class. For example, the first of the following 
statements creates a variable named c and assigns to it an instance of our BranchOf fice class. The 
second statement calls the getManagerName () method and displays the resulting information. 


BranchOffice("City of Industry", "1810 Elm", "CA", "91748-0019", "Ri Zhang") 
print (c.getManagerName () ) 


continued 
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Grasp Class, Instance, and Static Methods (continued) 


ython provides two different ways of creating class methods and static methods. The first way is 

to use the @classmethod decorator for a class method or the @staticmethod decorator for 
a static method. The second way is to use the classmethod() method or the staticmethod () 
method. Both ways work, and you should know how to use them, because you may encounter them 
in code. However, the classmethod() method and staticmethod() method are considered 
“un-Pythonic,” and using the decorators is considered better practice. 


Create a Class Method 


To create a class method, you place code inside the class definition, as for an instance method. But before 
the method header for the class method, you place the @classmethod decorator. This decorator tells 
Python to turn the method into a class method. 


For example, the first of the following statements starts the class definition, and the second is a comment, 
as before. The third statement supplies the @classmethod decorator. The fourth statement is the method 
header for the showClassInfo method. The fifth line is the method’s only statement, setting it to return 
a string including self.company, the company attribute of the class object. 


class BranchOffice(): 
# the def init function appears here 
@classmethod 
def showClassInfo(self) : 
return "Company Name: " + self.company 


You can also create a class method by using the classmethod() method to return a class method from 
an instance method. For example, if you have created an instance method called info() in the 
BranchOf fice class, you can create a class method of info () like this: 


BranchOffice.info = classmethod (BranchOffice.info) 
You can then call the info() method through the BranchOf fice Class like this: 


BranchOffice.info() 


Call a Class Method 
You can call a class method either from the class itself or from an instance of the class. 


From the class, use the class name followed by a period and the method name, like this: 


print (BranchOffice.showClassInfo() ) 


From an instance of the class, use the instance name followed by a period and the method name. For 
example, if you have created an instance called c, you can call the class method like this: 


print (c.showClassInfo() ) 
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Create a Static Method 


You create a static method in a similar way to a class method: You place the method’s code inside the class 
definition, but you precede it with the @staticmethod decorator, which tells Python to turn the method 
into a static method. 


For example, the first statement shown in the following code block starts the class definition, the second 
contains a comment, and the third provides the @staticmethod decorator. The fourth statement is the 
method header for the cm2cf method, which returns the approximate number of cubic feet for the number 
of cubic meters specified by the m3 parameter. The fifth line is the method's only statement, setting it to 
return m3 multiplied by 35.3, the number of cubic feet in a cubic meter. 


class BranchoOffice(): 
# the def init function appears here 
@staticmethod 
def cm2cf (m3): 
ise wba ney tis) 8) 


As with a class method, you can create a static method by using the staticmethod() method to return a 
static method from an instance method. For example, if you have created an instance method called 
convert () in the BranchOf fice class, you can create a static method of convert () like this: 


BranchOffice.convert = staticmethod (BranchOffice.convert) 


Call a Static Method 


To call a static method, you call it either via the class name and the method name or via the object name 
and the method name. 


For example, say you have instantiated an object called of fice1 of the BranchOf fice class. The class 
includes the static method jp. You can call the static method via the class like this: 


BranchOffice.jp() 
Or you can call the static method via the object like this: 


(osm ol— ees bon @) 
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Create an Instance Method 


I this section, you create an instance method called get Info() in the BranchOf fice class. This 
instance method pulls information from the instance’s attributes, such as the city attribute and 
the manager attribute, so that it can return an f-string containing information about the branch 
office the instance represents. 


In an instance method, the first parameter refers to the instance itself. The default term for this 
parameter is self; it is generally easiest and clearest to use self, but you can use a different term 
instead if you prefer. 


Create an Instance Method 


e In Visual Studio Code, open the Python script for your class. . a 9 
class3 1 x v ia. 
2) Click the line after the end of the init _() method, aaa CC 
. . 2 company = "CheeseWheat Associates" 
press to apply a four-space indent, and type the following >| sector = “faye scianee 
. ie 4 def __init_(self, city, street, state, zip, manager): 

statement, which declares the get Info() method and gives 5 self. city = city 

‘s 2 6 self.street = street i 

it the required self parameter. Press G@uOo. 7 selfstate = stte 


def getInfo(self): 


9 self.manager = man 

10 def sensei a) 

11 br = ( 

12 f"{self.city} orticen we 
13 


14 a = BranchOffice("Arcata", "442 Front", "CA", "95221-1111", 
“Aurora Smith") 

15 b = BranchOffice("Blythe", "6 Lincoln", "CA", "92225-1234", 
“Art Kimura") 

16 print(a.manager) 

17 print(a.street) 

18 print(a.city) 

19 print(a.state) 

20 print(a.zip) 


Python automatically indents the next line one step further. 


3 ) Type the following statement, which creates the variable 
br and begins assigning to it a group of f-strings that pull 
information from the instance attributes and combine it with 
static text. Press (G9 at the end of each line. 


bre = _/( 
f£"{self.city} Office\n\n" 


wT) Ln13,Col 13 Spaces:4 UTF-8 LF Python 310064-bit @ 0 


class3 
« ‘i ® class3 x ~O-. 
4 ) Type the following three statements, which add to the group sss p> Crapo > THPrton > Code Cates? © ces & 
. 10 def getInfo(self): 
of f-strings: u Bre. 
2 f'{self.city} Office\n\n" 
13 f"Manager: {self.manager}\n\n" 


f"Manager: {self.manager}\n\n" 
f£"{self.street}\n" 
f£"{self.city}, {self.state} {self.zip}" 


14 f"{self.street}\n" 

15 f'{self.city}, {self.state} errs ZY 

16 ) 

17 return & 

18 

19 a = BranchOffice("Arcata", "442 Front", "CA", "95221-1111", 
“Aurora Smith") 

20 b = BranchOffice("Blythe", "6 Lincoln", "CA", "92225-1234", 
"Art Kimura") 

21 print(a.getInfo())] 


) 


5 } Press to unindent one step, and then type the 
following return statement, which returns br: 


return br 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE Beyinon-oy +. O & ~ x 


guy@ac-Pro-3 ~ % /usr/local/bin/python3 /Users/guy/Dropbox/TYV_Python/Code/Classes/class3 
Arcata Office 


Select the five print () statements, and type the 
following print () statement over them: 


Manager: Aurora Smith 


442 Front 
Arcata, CA 95221-1111 
guy@ac-Pro-3 ~ % 


Ln 21,Col19 Spaces:4 UTF-8 LF Python 310.064-bit © 0 


print (a.getInfo () ) 


@ Click Run Python File in Terminal (>). the Terminal pane opens. 
@ Python displays the branch office information. 
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Create a Class Method 12 


n this section, you create a class method called showClassInfo() in the BranchOf fice class. 
This class method returns the class’s company attribute and sector attribute and places them in 
an f-string that it returns to the code that called it. 


To create the class method, this section uses the @classmethod decorator rather than the 
classmethod() method. The first parameter in the class header refers to the class itself. This 
section uses the default term for this parameter, self, but you can use a different term if you like. 


Create a Class Method 


1 ) In Visual Studio Code, open the Python script for ooe 1) 
@ class 3 x py O-. 
your class. Users > guy > Dropbox > TYV_Python > Code > Classes > ® class5 > ¢% BranchOffice > @ showClassinfo 
1 class BranchOffice: 
. 4 a 2 company = “CheeseWheat Associates" 
2) Click after the sector = "food science" line, and SB Tair aaa 
. ic lassmethod 
then press 09 to create a new line. o pi posctssnetsee a 
6 
a % def __init_(self, city, street, state, zip, ): 
© Type the following eclassmethod decorator, and then ‘| meee 
9 lf.st t = t 
press Ga: Pe metres eee 
11 self.zip = zip 
@classmethod a | wiennaaant 
4 br = ( 
@ Type the following method header, and then press @iC3: : Deedee ee 
q7 f"{self.street}\n" 
def showClassInfo (self) : Fe , f'{self.city}, {self.state} {self.zip}" 
20 return br 
Visual Studio Code indents the next line automatically. Sy ay aeranchotiiceOhia wer Saadicean wes pI oa 
Smith") 
5) Type the following two statements, which create ee ee ere eee, amt weer C20 


24 print(a.getInfo()) 


a variable named ci and assign to it the class’s 
company attribute and sector attribute plus some 
linking text. Press (G9. 


Ln6,Col9 Spaces:4 UTF-8 LF Python 3.10.064-bit @ O 


class5 


@classs xX e o-. 


Users > guy > Dropbox > TYV_Python > Code > Classes > @ class5 
6 ci = self.company + “, 


cil = self . company + " . a ‘ 7 ci = ci + self.sector ‘a oo 5 | 

ci = ci + self.sector + " trendsetter" =: Se ; 
9 def __init_(self, city, street, state, zip, manager): 

“ : 10 self.city = city 
6 ) Type the following statement, which ends the method a self.street = street 
12 self.state = state 
i 13 Uf.zip = zi 
and returns ci. Press G@NG9. : sels parader © salapek 
, 15 def getInfo(self): 

return ¢1 16 br = ( 

17 f"{self.city} Office\n\n" 
. . 18 f"Manager: {self.manager}\n\n" 
At the end of the script, edit the print () statement 19 f"{self.street)\n" i 
F 20 f'{self.city}, {self.state} {self.zip}" 

to the following: 21 ) 

22 return br 
: : 23 
print (BranchOffice.showClassInfo() ) 24 a = BranchOffice("Arcata", "442 Front", "CA", "95221-1111", “Aurora 
smith") 
i A A ° 25 b = BranchOffice("Blythe", "6 Lincoln", "CA", "92225-1234", "Ar’ 
@ Click Run Python File in Terminal ([>). Kimura") ia Mae's ’ 

26 print(BranchOffice.showClassInfo())] 


The Terminal pane opens PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE Dipyihon-qy +~ O fH ~ x 
S TERNAL 
guy@lac-Pro-3 ~ % /usr/Local/bin/python3 /Users/quy/Dropbox/TYV_Python/Code/Classes/class5 
heesewheat Associates, a food science trendsetter 
‘quy@ac-Pro-3 ~ % (] 
0 Ln 26,Col 36 Spaces: UTF-8 LF Python 3.10064-bit A O 


@ The class method displays the class information. 
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Create a Static Method 


ip this section, you create a static method in the BranchOf fice class. The method is called 
cm2cf() and converts cubic meters to cubic feet. The method takes a single argument, m3, which 
gives the number of cubic meters, and returns the corresponding number of cubic feet. Because a 
static method accesses neither the class nor any instance of it, it does not use the self parameter. 


This section uses the @staticmethod decorator rather than the staticmethod() method to tell 
Python to create the static method. 


Create a Static Method 


@ In Visual Studio Code, open the Python script for your class. ane ==) = 
z .: * Users > guy > Dropbox > TYV_Python > Code > Classes > @ classé » ¢s BranchOffice > @ cm2cf 
Click on the blank line following the return br ge a 
statement at the end of the getInfo() method, and | ee 
then press to indent the line by one step. | eer ake 
7 ci = ci + self.sector + " trendsetter" 
3 f 8 return ci 
© Type the following estat icmethod decorator, and then 2 det Linke ont, city, street, state, sip, manager) 
press GED: || | eee : 
13 self.zip = zip 
eapeiaemet hod oC | gen 
16 br = ( 
. f"{self.city} Office\n\n" 
4 ) Type the following method header, and then press (uC: ‘8 Pager (anger 
19 f"{self.street}\n" 
20 f"{self.city}, Late {self.zip}" 
def cm2cf (m3): 2 es 
3 a 
Python indents the next line by another step. igen a 4 | 
26 ae BranchOffice("Arcata", "442 Front", "CA", "95221-1111", “Aurora 
Smith") 


Ln25,Col9 Spaces: UTF-8 LF Python 3.10.064-bit @ O 


@ ype the following return statement, which returns a 


string including the m3 value multiplied by 35.3 and Eas ; 
lightly rounded. Press | Enter | twice. Me Ne cae eer Seek eee @ 
def cm2cf(m3): 

return str (round (m3 * 35.3 ; i) ) + | return str(round(m3 * 35.3, 1)) +" cubic ee 5) 

‘ a= Branchoffice("Arcata”, "442 Front", "CA", "95221-1111", ra 
"cubic feet" aa ee ee "6 Lincoln", "CA", "92225-1234", “Art 

Kimura") 
6 ) At the end of the script, change the print () AE the number of cubic 


statement to the following, which prompts the user to 
enter the number of cubic meters, converts the resulting 
string to a float, passes it to the cm2cf method, and 
displays the result. 


PROBLEMS OUTPUT TERMINAL DEBUG CONSOLE Dlpytnon-gy +~ O tf ~ x 
print (BranchOffice.cm2cf (float (input guy Pro-3 = « 8 aioe 
inter r of cubic meters: 12 


("Enter the number of cubic meters: ")))) 
@ Click Run Python File in Terminal ([>). 
The Terminal pane opens. 
6 Type the input number and press GuCo. 
@ The result appears. 
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CHAPTER 


Review the Class’s Code 12 


his section presents the code for the class you have created in this chapter. The class starts 

with the class definition (A), followed by statements defining the class attributes company 
(B) and sector (C). The @classmethod decorator (D) precedes the showClassInfo() class 
method. The _ init __() method (E) declares and populates variables for each new instance of the 
class. The get Info() instance method (F) displays information about a particular instance. The @ 
staticmethod decorator (G) introduces the cm2cf () static method, which converts cubic meters 
to cubic feet. The code then instantiates two instances (H) of the class, and the print () statement 
(I) displays information. 


class BranchOffice: 
company = "CheeseWheat Associates" 
sector = "food science" 
@classmethod 
def showClassInfo(self): 
ci = self.company +", a 
ci = ci + self.sector + " trendsetter" 
return ci 
@ cer __init__(self, city, street, state, zip, manager): 
self.city = city 
self.street = street 
self.state = state 
self.zip = zip 
self.manager = manager 
Q@— cet getInfo(self): 
br = ( 
f"{self.city} Office\n\n" 
f"Manager: {self.manager}\n\n" 
f"{self.street}\n" 
f"{self.city}, {self.state} {self.zip}" 


) 
return br 
staticmethod 
def cm2cf(m3): 
return str(round(m3 * 35.3, 1)) + " cubic feet" 
a = BranchOffice("Arcata", "442 Front", "CA", "95221-1111", 
“Aurora Smith") 
b = BranchOffice("Blythe", "6 Lincoln", "CA", "92225-1234", 
"Art Kimura") 
print(BranchOffice.cm2cf(float(input("Enter the number of 
cubic meters: ")))) 
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a mode, 96 
a+ mode, 96 
abs () function, 166, 168 
accessing 
contents of imported modules, 45 
data in lists, 244-245 
adding 
comments to code, 42-43 
else blocks, 225, 229 
finally blocks, 225, 229 
items 
to lists, 240-241 
to tuples, 65 
key/value pairs to dictionaries, 254-255 
adjusting 
order of operations, 113 
order of precedence using parentheses, 115 
string capitalization, 200-203 
aiter() function, 168 
algorithms, 4 
alias, importing modules/objects under an, 46 
all() function, 168 


American Standard Code for Information Interchange (ASCII), 
183 


AND (&) operator, 120, 126 
anext () function, 168 

any () function, 168 

Append and Read Mode, 96, 107 
append () method, 239, 240-241 
Append Mode, 96 

appending data to files, 106-107 
applying themes, 22-23 

Arch, 15 

arithmetic operators, 112-115 
arrays, compared to lists, 237 


ASCII (American Standard Code for Information Interchange), 
183 


ascii() function, 168 


AssertionError, 222 
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assigning values to variables, 53 
assignment operators, 116-117 

Atom, 19 

AttributeError, 222 

Auto Save feature (Visual Studio Code), 33 
auto saving, in Visual Studio Code, 27 
AutoComplete list, 35 


B 

backslash, 83, 185 

basename() method, 95 

bin() function, 168, 170, 171 

binary strings, 171 

bitwise operators, 126-127 

bool () function, 62-63, 74, 75, 168 
Boolean values, 62-63 

braces ({}), 206-207, 212-213, 217, 248, 250 
break statement, 145, 149, 151, 154, 155 
breakpoint () function, 168 

build types, 7 

built-in functions, 168-171 

byte code, 220 

bytearray() function, 168 

bytes () function, 168 


C 
C programming language, 54 
callable() function, 168 
calling 
class methods, 272 
instance methods, 271 
static methods, 273 
capitalization 
of classes, 263 
of strings, 200-203 
capitalize() method, 188 


carriage-return characters, creating multiline strings using, 
187 


casefold() method, 188, 203 
center() method, 188, 189 
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changing 
order of operations, 113 
order of precedence using parentheses, 115 
string capitalization, 200-203 
character codes, 183 
character sets, 183 
chdir() method, 82-83, 92 
child directory, 78 
chr () function, 75, 168 
class attributes 
about, 266-267 
returning, 269 
setting, 268-269 
class methods 
about, 270 
calling, 272 
creating, 272, 275 
classes and instances 
about, 57, 262 
class attributes, 266-269 
class methods, 270-273 
code for classes, 277 
creating 
class methods, 275 
classes, 262, 264-265 
instance methods, 274 
static methods, 276 
instance attributes, 266-267 
instance methods, 270-273 


instantiating instances, 
264-265 


setting class and instance attributes, 
268-269 


static methods, 270-273 
classmethod() function, 168, 272, 275 
cleaning up strings, 192-193 
clear() method, 239, 242-243, 251, 256 
close() method, 97, 100-101 
closing files manually, 97 
cm2cf£() method, 276 
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code editors 
about, 16 


compared with integrated development environments 
(IDEs), 17 


entering comments in, 41 
examples of, 19 
recommended, 19 
coding 
adding comments to code, 42-43 
for classes, 277 
commenting out the code, 41 
comments, 40-43 
creating scripts in Visual Studio Code, 32-33 
executing commands in Terminal window, 38 
importing modules/objects, 44-49 
main() function, 30-31 
methods of modules, 48-49 
repetitive code, 37 
running 
code in Visual Studio Code, 34-37 
scripts in Terminal window, 39 
saving scripts in Visual Studio Code, 32-33 
writing code in Visual Studio Code, 34-37 
collections, displaying, 73 
colon (:), 131, 164 
command line, launching scripts via, 31 
commenting out the code, 41 
comments, 40-43 
comparison operators, 118-119 
compile () function, 168 
compile-time errors, 220 
complex () function, 75, 168 
computing platform, 4 
concatenating 
integers, 197 
strings, 196-197 
+ operator, 59 
configuring Visual Studio Code, 26-27 
\ (continuation) character, 40 
continue statement, 145, 156-157 
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continuing loops, 145 
converting 
binary strings to decimal values, 171 
data types, 74-75 
hexadecimal strings to decimal values, 171 
octal strings to decimal values, 171 
copy () method, 90, 239, 251, 253 
copying files and directories, 88-91 
copytree() method, 90 
count () method, 188, 190, 239, 244-245 
creating 
class methods, 272, 275 
classes, 262, 264-265 
comments using # character, 40 
custom exceptions, 232-233 
dictionaries 
about, 250 
from existing iterables, 252-253 
directories, 84-87 
empty tuples, 65 
functions 
with no parameters and no returns, 176 
with no parameters but returns, 174-175 
with optional parameters, 178-179 
with parameters and returns, 172 
with parameters but no returns, 173 
that return multiple values, 177 
if statements, 133 
if...elif statements, 137 
if...elif...else statements, 139 
if...else statements, 135 
instance methods, 271, 274 
instances of classes, 263 
lists, 238 
for loops, 148-149 
multiline strings, 186-187 
nested if statements, 141 
nested try...except blocks, 230-231 
numeric for loops using range () function, 147 
scripts 
about, 58-59 
in Visual Studio Code, 32-33 
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sets with contents, 67 

single-line strings, 184-185 

static methods, 273, 276 

strings 
about, 182, 204-209 
using . format method, 212-213 
using f-strings, 214-215 
using interpolation operator, 210-211 
using template strings, 216-217 

variables, 53 

while loops, 152-153 

cross-platform programming, 4 


D 
data 
appending to files, 106-107 
writing to files, 102-103 
Data section, in files, 79 
data types 
about, 54-55 
converting, 74-75 
for default values, 179 
exception, 57 
instance, 57 
mapping, 56 
numeric, 54-55 
sequence, 55 
set, 56 
day_of_week() function, 167 
%d operator, 211 
Debian-based distributions, 15 


decimal values, converting binary, octal, or hexadecimal 
strings to, 171 


deduplicate, 243 

def keyword, 164, 165 

default values, data types for, 179 

definite iteration, using for loops for, 144 
delattr() function, 168 

deleting directories, 84-87 

development build, 7 

development tools, for Python, 16-19 
dict data type, 56 
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dict () function, 75, 168 
dictionaries 
about, 248-249 
adding key/value pairs to, 254-255 
creating 
about, 250 
from existing iterables, 252-253 
for loops that iterate through, 149 
formatting strings with, 209 
methods for, 251 
removing key/value pairs from, 256-257 
returning 
keys and values from, 258-259 
values, 250 
working with, 72-73 
dir() function, 47, 168 
directories. see files and directories 
directories and files 
about, 78-79 
appending data to files, 106-107 
checking file status, 100-101 
closing files, 97, 100-101 
copying, 88-91 
creating 
directories, 84-87 
files, 98-99 
deleting directories, 84-87 
file structure, 79 
listing, 80-81 
loading os module, 80-81 
modules for working with, 79 
moving, 88-91 
navigating directories, 82-83 
open() function, 96 
opening files 
about, 98-99 
for reading and writing, 104-105 
reading text files, 108-109 
renaming, 88-91 
splitting file paths, 94-95 
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system information, 92-93 

user information, 92-93 

writing data to files, 102-103 
directory path, 78 
dirname () method, 95 
disabling path length limit, 11 
displaying 

collections, 73 

information using print () function, 171 
distributions, 4 
division (/) operator, 115 
divmod() function, 168 
domain-specific programming language, 4 
double quotes, 69 
downloading 

Python on Windows, 8-11 

Visual Studio Code, 20-21 
duplicate values, 236 
dynamic typing, 52 


E 
elements, 66 
else blocks, adding, 225, 229 


else statements, in loops, 
158-159 


encode () method, 188, 189 
ending for loops, 149 
End-of-file marker, in files, 79 
endswith() method, 188, 190 
engineers, as Python users, 5 
entering 
comments in code editors, 41 
comments in IDEs, 41 
comments in Terminal windows, 41 
enumerate () function, 168 


environment variables, returning 
information using, 93 


EOFError, 222 
= operator, 116 
equal to (==) operator, 118 
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error handling 
adding 
else blocks, 229 
finally blocks, 229 
causing errors, 226-227 
creating 
custom exceptions, 232-233 
nested try. ..except blocks, 230-231 
error types, 220-221 
identifying common errors, 222-223 
raising exceptions manually, 228 
trapping exceptions, 226-227 
try...except block, 224-225 
escape character, 83 
eval () function, 168 
exception data type, 57 
exceptions 
creating custom, 232-233 
raising manually, 228 
trapping, 225, 226-227 
exec () function, 168 
exiting loops early using break statements, 155 
expandtabs() method, 189 
expanduser () method, 82-83, 92 
explicit conversion, 74 
extend() method, 239, 240-241 
extensions, for Visual Studio Code, 24-25 


F 
Fedora, 15 
file paths, splitting, 94-95 
FileExistsError error, 85 
files and directories 
about, 78-79 
appending data to files, 106-107 
checking file status, 100-101 
closing files, 97, 100-101 
copying, 88-91 
creating 
directories, 84-87 
files, 98-99 
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deleting directories, 84-87 
file structure, 79 
listing, 80-81 
loading os module, 80-81 
modules for working with, 79 
moving, 88-91 
navigating directories, 82-83 
open() function, 96 
opening files 

about, 98-99 


for reading and writing, 
104-105 


reading text files, 108-109 
renaming, 88-91 
splitting file paths, 94-95 
system information, 92-93 
user information, 92-93 
writing data to files, 102-103 
filter() function, 168 
finally blocks, adding, 229 
find() method, 188, 189, 198-199 
float data type, 54 
float () function, 75, 168 
floating-point numbers 
storing, 54 
troubleshooting, 115 
working with, 60-61 
FloatingPointError, 222 
floor division, 112 
folder path, 78 
folders. see files and directories 
for loops 
creating, 148-149 
ending, 149 
how they work, 146-147 
using for definite iteration, 144 
format () method, 168, 188, 189 
. format method 
building strings using, 212-213 


formatting strings using, 
206-207 
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format_map() method, 189 
formatting 

strings, 204-205 

strings using . format method, 206-207 

strings using f-strings, 207-209 

strings using template strings, 209 
from. ..import statement, 44 
fromkeys() method, 251, 252-253 
frozenset () function, 169 
f-strings 

about, 204 

building strings using, 214-215 

formatting strings using, 207-209 
function description, 164 
function name, 164 
functions 

abs (), 166, 168 

aiter(), 168 


all (), 168 
anext (), 168 
any (), 168 


ascii(), 168 

bin(), 168, 170, 171 

bool (), 62-63, 74, 75, 168 

breakpoint (), 168 

built-in, 168-171 

bytearray(), 168 

bytes (), 168 

callable(), 168 

chr (), 75, 168 

classmethod(), 168, 272, 275 

compile(), 168 

complex (), 75, 168 

creating 
with no parameters and no return, 176 
with no parameters but a return, 174-175 
with optional parameters, 178-179 
with parameters and returns, 172 
with parameters but no returns, 173 
that returns multiple values, 177 

day_of week(), 167 

delattr(), 168 
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dict (), 75, 168 

dir(), 47, 168 

divmod (), 168 

enumerate (), 168 

eval (), 168 

exec (), 168 

filter(), 168 

float (), 75, 168 
frozenset (), 169 
getattr(), 169 
globals(), 167, 169 
hasattr(), 169 

hash(), 169 

help (), 169 

hex (), 75, 169, 170, 171 
id(), 122, 123, 169 

input (), 58-59, 164, 169, 170 
int (), 58-59, 74, 75, 115, 169, 171 
isinstance(), 169 
issubclass(), 169 
iter(), 169 

len(), 169, 191 

list (), 75, 169, 170 
locals (), 169 

main(), 30-31 
make_title(), 201-202 
map (), 169 

max(), 169 

memoryview(), 169 

min(), 169 

mkdir (), 84-87 

next (), 169 

object (), 169 

oct (), 75, 169, 170, 171 
open(), 79, 96-109, 169, 170 
ord(), 75, 170 

parameters and returns, 166-167 
pow(), 170 

print (), 53, 58-59, 150, 154, 164, 167, 170, 171, 277 
property(), 170 

range (), 147, 170 

repr(), 170 
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G 


general-purpose programming language, 4 


reversed(), 170 
round (), 170 

set (), 67, 75, 170 
setattr(), 168, 170 
slice(), 170 
sorted(), 170, 171 
staticmethod(), 170, 276 
str(), 68-69, 75, 170 
sum(), 170 

super (), 170 

syntax, 164-165 
tuple(), 75, 170 
type (), 170 

zip(), 170 


generating 


class methods, 272, 275 
classes, 262, 264-265 
comments using # character, 40 
custom exceptions, 232-233 
dictionaries 

about, 250 


from existing iterables, 252-253 


directories, 84-87 
empty tuples, 65 
functions 


instances of classes, 263 
lists, 238 
for loops, 148-149 
multiline strings, 186-187 
nested if statements, 141 
nested try...except blocks, 230-231 
numeric for loops using range () function, 147 
scripts 
about, 58-59 
in Visual Studio Code, 32-33 
sets with contents, 67 
single-line strings, 184-185 
static methods, 273, 276 
strings 
about, 182, 204-209 
using . format method, 212-213 
using f-strings, 214-215 
using interpolation operator, 210-211 
using template strings, 216-217 
variables, 53 
while loops, 152-153 
GeneratorExit, 222 
get () method, 251 
getattr() function, 169 
getcwd() method, 80 
getInfo() method, 274, 277 
getpass module, 92 
Getting Started screen (Visual Studio Code), 23 
getuser() method, 92 


with no parameters and no returns, 176 
with no parameters but returns, 174-175 
with optional parameters, 178-179 
with parameters and returns, 172 
with parameters but no returns, 173 
that return multiple values, 177 
if statements, 133 H 
if...elif statements, 137 hasattr() function, 169 
if...elif...else statements, 139 hash() function, 169 
if...else statements, 135 Header section, in files, 79 
instance methods, 271, 274 help () function, 169 


glob() method, 80 

glob (Global) module, 79 

globals() function, 167, 169 

greater than (>) operator, 118 

greater than or equal to (>=) operator, 118 
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hex() function, 75, 169, 170, 171 
hexadecimal strings 
converting to decimal values, 171 
returning, 171 
high-level programming language, 54 
home directory, returning, 92 
HOME variable, 93 


I 
id() function, 122, 123, 169 
identity operators, 122-123 
IDLE app, 9, 18 
if statements 
about, 30-31, 130-132 
creating, 133 
if...elif statement, 136-137 
if...elif...else statement, 138-139 
if...else statement, 134-135 
nested, 140-141 
if...elif statement, 130, 136-137 
if...elif...else statement, 130, 138-139 
if...else statement, 130, 134-135 
immutable data, 55 
implicit conversion, 74 
import statement, 44, 79 
import sys command, 81 
ImportError, 222 
importing 
modules, 44-48 
objects, 44-48 
scripts, 31 
in operator, 124 
indefinite iteration, using while loops for, 144-145 
IndentationError, 223 
index() method, 189, 198-199, 239, 244-245 
indexed lists, 236 
IndexError, 222 
infinite loops, 151 
infinite while loops, 153 
__init___() method, 266-267, 268-269, 277 
input () function, 58-59, 164, 169, 170 
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insert () method, 239 
installing 
Python 
on Linux, 14-15 
on Macs, 12-13 
on Windows, 8-11 
Visual Studio Code 
about, 20-21 
extensions for, 24-25 
on Linux, 21 
on macOS, 21 
instance attributes 
about, 266-267 
setting, 268-269 
instance data type, 57 
instance methods 
about, 270 
calling, 271 
creating, 271, 274 
instances. see classes and instances 
instantiating instances, 264-265 
int data type, 54 
int () function, 58-59, 74, 75, 115, 169, 171 
integer division, 112 
integers 
concatenating, 197 
storing, 54 
working with, 58-59 
integrated development environments (IDEs) 
about, 9, 17 
compared with code editors, 17 
entering comments in, 41 
examples of, 18 
recommended, 19 
Interactive Interpreter, importing scripts into, 31 
interpolation operator 
building strings using, 210-211 
formatting strings using, 204-205 
interrupting 
infinite while loops, 153 
loops, 145 
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i0S, 5 

iPadOS, 5 

is not operator, 122, 123 

is operator, 122, 123 

isabls() method, 95 

isalnum() method, 140, 188, 190 
isalpha() method, 140, 188 
isascii() method, 140, 188 
isdecimal() method, 188 
isdigit() method, 188 
isfile() method, 82-83 
isidentifier() method, 188 
isinstance() function, 169 
islower() method, 188, 190 
isnumeric() method, 140, 188, 190 
isprintable() method, 188 
isspace() method, 140, 188 
issubclass() function, 169 
istitle() method, 188 
isupper() method, 188, 190, 200-203 
items () method, 251, 258-259 
iter () function, 169 


J 


join() method, 189 


joining strings using concatenation operator, 196 


K 


KeyboardiInterrupt, 222 

KeyError, 222 

keys () method, 258-259 

key/value pairs 
adding to dictionaries, 254-255 
removing from dictionaries, 256-257 
returning from dictionaries, 258-259 


L 


LANG variable, 93 

launching 
scripts via command line, 31 
Visual Studio Code, 22-23 
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leading spaces, 192 
len() function, 169, 191 
less than (<) operator, 118 
less than or equal to (<=) operator, 118 
Linux 
about, 5 
installing 
Python, 14-15 
Visual Studio Code on, 21 
updating Python, 15 
versions for, 7 
list data type, 55 
list () function, 75, 169, 170 
listdir() method, 80 
lists 
about, 236-237 
accessing data in, 244-245 
adding items to, 240-241 
compared to arrays, 237 
compared to sets, 237 
compared to tuples, 237 
creating, 238 
creating for loops that use, 148 
of files and directories, 80-81 
locating items in, 244-245 
methods for, 239 


of methods/variables in modules/ 
objects, 47 


removing items from, 242-243 
sorting items in, 246-247 
using for loops with, 146-147 
working with, 70-71 

ljust() method, 189 

loading os (Operating System) module, 80-81 

locals () function, 169 

logical errors, 221 

logical operators, 120-121 

LOGNAME variable, 93 

loops 
for, 146-149 
about, 144-145 
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break statements in, 154-155 
continue statements in, 156-157 
else statements in, 158-159 
infinite, 151 
nesting, 160-161 
while, 150-153 
lower () method, 188, 203 
low-level programming language, 54 
lstrip() method, 189 


M 
macOS 
about, 5 
installing Visual Studio Code on, 21 
versions for, 7 
Macs 
installing Python, 12-13 
updating versions on, 13 
main() function, 30-31 
makedirs() method, 84-87 
make_title() function, 201-202 
maketrans() method, 189 
map () function, 169 
mapping data type, 56 
mathematicians, as Python users, 5 
max() function, 169 
members, 66 
membership operators, 124-125 
MemoryError, 222 
memoryview() function, 169 
methods 
about, 270 
append (), 239, 240-241 
basename (), 95 
capitalize(), 188 
casefold(), 188, 203 
center (), 188, 189 
chdir(), 82-83, 92 
for checking/changing case, 188 
clear (), 239, 242-243, 251, 256 
close(), 97, 100-101 
em2cf£(), 276 
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copy (), 90, 239, 251, 253 
copytree(), 90 

count (), 188, 190, 239, 244-245 
for dictionaries, 251 
dictionary, 251 

dirname (), 95 

encode (), 188, 189 
endswith(), 188, 190 
expandtabs(), 189 
expanduser (), 82-83, 92 
extend (), 239, 240-241 
find(), 188, 189, 198-199 
for finding within strings, 189 
format (), 168, 188, 189 

. format, 206-207, 212-213 
format_map(), 189 
fromkeys (), 251, 252-253 
get(), 251 

getcwd(), 80 

getInfo(), 274, 277 
getuser(), 92 

glob (), 80 

index (), 189, 198-199, 239, 244-245 
insert (), 239 

isabls(), 95 

isalnum(), 140, 188, 190 
isalpha(), 140, 188 
isascii(), 140, 188 
isdecimal (), 188 
isdigit (), 188 

isfile(), 82-83 
isidentifier(), 188 
islower(), 188, 190 
isnumeric(), 140, 188, 190 
isprintable(), 188 
isspace(), 140, 188 
istitle(), 188 
isupper (), 188, 190, 200-203 
items (), 251, 258-259 
join(), 189 

keys (), 258-259 

for laying out strings, 189 
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methods (continued) 
listdir(), 80 
listing in modules/objects, 47 
for lists, 239 
ljust (), 189 
lower (), 188, 203 
lstrip(), 189 
makedirs (), 84-87 
maketrans(), 189 
of modules, 48-49 
move (), 90, 91 
partition(), 189, 192 
pop (), 239, 242-243, 251, 256 
popitem(), 251, 256 
read(), 104-105 
readable(), 105 
reload(), 47 
remove (), 88, 239, 242-243 
rename (), 88 
replace(), 188, 189 
for returning information about strings, 188 
reverse (), 239, 246-247 
rfind(), 189, 198-199 
rindex(), 189 
rjust (), 189 
rmdir (), 86-87, 88 
rmtree(), 86 
rpartition(), 189 
rsplit(), 189 
rstrip(), 189 
seek (), 104-105 
seekable(), 105 
setdefault(), 251, 254-255 
showClassInfo(), 275 
shutil.copy(), 89 
shutil.copyfile(), 89 
sort (), 239, 246-247 
split (), 94-95, 189 
splitext (), 94-95 
splitlines(), 189 
startswith(), 188 
string, 188-189 
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strip (), 189 
swapcase(), 188 
title(), 188, 200-203 
today (), 167 
for transforming strings, 189 
translate(), 189 
update(), 251, 254-255 
upper (), 188 
values (), 251, 258-259 
writable(), 105 
write(), 102-103, 104-105 
zf£ill(), 188, 189, 193 
min() function, 169 
mkdir () function, 84-87 
modifying 
order of operations, 113 
order of precedence using parentheses, 115 
string capitalization, 200-203 
ModuleNotFoundError, 222 
modules 
importing 
about, 44-48 
under an alias, 46 
objects from, 45 
scripts into, 31 
listing methods/variables in, 47 
methods of, 48-49 
reloading, 47 
unimporting, 49 
for working with files and directories, 79 
modulus, 112 
move () method, 90, 91 
moving files and directories, 88-91 
multiline strings 
creating, 186-187 
creating informal comments using, 40 
mutable dictionary, 248 
mutable lists, 236 


N 


NameError, 222 
navigating directories, 82-83 
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nested if statements, 140-141 

nested try. ..except blocks, creating, 230-231 
nesting loops, 145, 160-161 

new-line characters, creating multiline strings using, 187 
next () function, 169 

not equal to (!=) operator, 118 

not in operator, 124 

NOT (~) operator, 120, 126 
NotImplementedError, 222 

numeric conditions, while loop using, 150 
numeric data types, 54-55 


0 


object () function, 169 
objects 
importing 
about, 44-48 
under an alias, 46 
from modules, 45 
listing methods/variables in, 47 
unimporting, 49 
oct () function, 75, 169, 170, 171 
octal strings 
converting to decimal values, 171 
returning, 171 
OLDPWD variable, 93 
open() function, 79, 96-109, 169, 170 
opening 
files, 98-99 


files for reading and writing, 
104-105 


operating system 
determining, 92 
verifying, 81 

operations, order of, 113 

operators 
arithmetic, 112-115 
assignment, 116-117 
bitwise, 126-127 
comparison, 118-119 
identity, 122-123 
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logical, 120-121 
membership, 124-125 
OR (|) operator, 120, 126 
ord() function, 75, 170 
order of operations, 113 
ordered data, 55 
ordered dictionary, 248, 249 
ordered lists, 236 
os (Operating System) module, 79, 80-81, 88, 90, 93 
OSError, 222 


OverflowError, 222 


P 
parameters 
about, 164 
creating functions 
with no returns and no, 176 
with no returns but, 173 
with optional, 178-179 
with returns and, 172 
with returns but no, 174-175 
function, 166 
parent directory, 78 
parentheses, changing order of precedence using, 115 


Parentheses, Exponentiation, Multiplication, Division, 
Addition, and Subtraction (PEMDAS), 112, 113 


partition() method, 189, 192 
PATH variable, 11 


PEMDAS (Parentheses, Exponentiation, Multiplication, 
Division, Addition, and Subtraction), 112, 113 


+ operator, 116 

+= operator, 116 

pop() method, 239, 242-243, 251, 256 
popitem() method, 251, 256 

pow() function, 170 


print () function, 53, 58-59, 150, 154, 164, 167, 170, 
171, 277 


programming language, 4 
property () function, 170 
PWD variable, 93 

.py file extension, 44 
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PyCharm, 18 
Python 
about, 4-5 
applying themes, 22-23 
choosing versions, 6-7 
configuring Visual Studio Code, 26-27 
development tools for, 16-19 
downloading 
Visual Studio Code, 20-21 
on Windows, 8-11 
installing 
on Linux, 14-15 
on Macs, 12-13 
Visual Studio Code, 20-21 
Visual Studio Code extensions, 24-25 
on Windows, 8-11 
launching Visual Studio Code, 22-23 
upgrading on Windows, 11 
Python Software Foundation (website), 5 


Q 


quotes 
about, 69 
creating multiline strings using triple, 186 
inside strings, 185 


R 


x mode, 96 
r+ mode, 96 
range data type, 55 
range () function, 147, 170 
Read and Write Mode, 96, 108 
read() method, 104-105 
Read Mode, 96, 108 
readable() method, 105 
reading 
opening files for writing and, 104-105 
text files, 108-109 
ReferenceError, 222 
release candidates, 7 
reload() method, 47 
reloading modules, 47 
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remove () method, 88, 239, 242-243 
removing 
items 
from lists, 242-243 
from tuples, 65 
key/value pairs from dictionaries, 256-257 
rename () method, 88 
renaming files and directories, 88-91 
repeating strings, 196-197 
repetition, nesting loops to create complex, 145 
repetition operator, 197 
repetitive code, 37 
replace () method, 188, 189 
repr () function, 170 
return statement, 164, 165 
returning 
binary strings, 171 
class attributes, 269 
hexadecimal strings, 171 
home directory, 92 
information about strings, 190-191 
information using environment variables, 93 
keys from dictionaries, 258-259 
octal strings, 171 
parts of strings via slicing, 194-195 
username, 92 
values, 250 
values from dictionaries, 258-259 
returns 
about, 164 
creating functions 
with no parameters and no, 176 
with no parameters but, 174-175 
with parameters and, 172 
with parameters but no, 173 
function, 166 
reverse () method, 239, 246-247 
reversed() function, 170 
xfind() method, 189, 198-199 
rindex() method, 189 
rjust() method, 189 
rmdir() method, 86-87, 88 
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rmtree() method, 86 
round () function, 170 
rpartition() method, 189 
rsplit() method, 189 
rstrip() method, 189 
running 
code in Visual Studio Code, 34-37 
scripts 
about, 58-59 
in Terminal window, 39 
runtime errors, 220 


RuntimeError, 222 


Ss 


saving scripts in Visual Studio Code, 32-33 


scientists, as Python users, 5 
scripts 
creating, 58-59 


creating in Visual Studio Code, 32-33 


importing 
about, 31 
scripts into other, 31 
launching via command line, 31 
running 
about, 58-59 
in Terminal window, 39 
saving in Visual Studio Code, 32-33 
seek () method, 104-105 
seekable() method, 105 
self keyword, 266-267 
semantic errors, 221 
sequence data type, 55 
set data type, 56 
set () function, 67, 75, 170 
setattr() function, 168, 170 
setdefault() method, 251, 254-255 
sets 
compared to lists, 236, 237 
working with, 66-67 
setting 
class attributes, 268-269 
instance attributes, 268-269 
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SHELL variable, 93 

showClassInfo() method, 275 

shutil (Shell Utility) module, 79, 87, 88, 90, 91 
shutil.copy() method, 89 
shutil.copyfile() method, 89 

signed right shift (>>), 126 

single quotes, 69 

# (single-line) character, 40, 43 

single-line strings, creating, 184-185 

slice() function, 170 


slicing, returning parts of strings via, 
194-195 


sort () method, 239, 246-247 
sorted() function, 170, 171 
sorting items in lists, 246-247 
split () method, 94-95, 189 
splitext() method, 94-95 
splitlines() method, 189 
splitting file paths, 94-95 
stable build, 7 
startswith() method, 188 
statements 
about, 164 
break, 145, 149, 151, 154, 155 
continue, 145, 156-157 
else, 158-159 
from...import, 44 
if...elif, 130, 136-137 
if...elif...else, 130, 138-139 
if...else, 130, 134-135 
import, 44, 79 
return, 164, 165 
static methods 
about, 270 
calling, 273 
creating, 273, 276 
static typing, 52 
staticmethod() function, 170, 276 
StopIteration, 223 
storing 
floating-point numbers, 54 
integers, 54 


291 


July 1, 2022 3:15 PM 


Index 


str data type, 55 
str() function, 68-69, 75, 170 
strings 
about, 182-183 
backslash inside, 185 
building 
about, 182 
for loops that iterate through, 148-149 
using . format method, 212-213 
using f-strings, 214-215 
using interpolation operator, 210-211 
using template strings, 216-217 
checking/changing capitalization of, 200-203 
cleaning up, 192-193 
concatenating, 196-197 
formatting 
about, 204-205 
using . format method, 206-207 
using f-strings, 207-209 
using template strings, 209 
multiline, 186-187 
quotes inside, 185 
repeating, 196-197 
returning 
information about, 190-191 
parts of, via slicing, 194-195 
searching for strings inside other, 198-199 
single-line, 184-185 
strings, 204-209 
tools for manipulating, 183 
transforming, 192-193 
working with, 68-69 
strip() method, 189 
Sublime Text, 19 
sum() function, 170 
sunsetting, 6 
super () function, 170 
SUSE, 15 
swapcase() method, 188 
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syntax errors, 220-221 
SyntaxError, 223 
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